Zuletzt geändert: 14.03.2026 11:04
Dataset
#
Das Dataset-Objekt (Datenmenge) ermöglicht den Zugriff auf eine Treffermenge von gleichartigen Datensätzen. Die aktuelle Datenmenge aus der Eingabemaske ist stets im Kontext von iScript-Menübefehlen als Variable Dataset verfügbar. Es ist aber auch möglich, ein Dataset programmatisch über Client.CreateDataset zu erzeugen.
Eigenschaften
#
| Eigenschaft | Typ | Zugriff | Beschreibung |
|---|
EOF | Boolean | nur lesen | True, wenn das Ende der Datenmenge erreicht ist |
BOF | Boolean | nur lesen | True, wenn der Anfang der Datenmenge erreicht ist |
Values[Index] | Variant | lesen/schreiben | Lesen und Setzen der einzelnen Feldwerte |
DOC | IDataObjectClass | nur lesen | Zugriff auf die Datenobjektklasse |
State | Integer | nur lesen | Aktueller Modus der Datenmenge (siehe Konstanten) |
ID | Integer | nur lesen | ID des aktuellen Datensatzes |
QueryBuilder | IQueryBuilder | nur lesen | Zugriff auf den QueryBuilder der Datenmenge |
UserVars | IUserVars | nur lesen | Zugriff auf die Benutzervariablen |
Methoden
#
Navigation
#
| Methode | Beschreibung |
|---|
First | Wechselt zum ersten Datensatz |
Prior | Wechselt zum vorhergehenden Datensatz |
Next | Wechselt zum nächsten Datensatz |
Last | Wechselt zum letzten Datensatz |
Bearbeitung
#
| Methode | Beschreibung |
|---|
Search | Wechselt in den Sucheingabe-Modus |
Post | Speichert die aktuellen Änderungen oder startet die Suche |
Append | Fügt einen neuen Datensatz an |
Clear | Löscht die Suchmaske |
Edit | Wechselt in den Änderungsmodus |
Cancel | Bricht das Ändern oder Blättern ab |
Delete | Löscht den aktuellen Datensatz |
Close | Schließt die Datenmenge |
RefreshCurrent | Aktualisiert den aktuellen Datensatz aus der Datenbank |
Sonstige
#
| Methode | Beschreibung |
|---|
SaveCurrentLink(Target) | Speichert eine Verknüpfung (.cnlnk-Datei) zum aktuellen Datensatz |
Update(Fields, Values, Options) | Aktualisiert mehrere Felder gleichzeitig |
Konstanten – DatasetState
#
| Konstante | Wert | Beschreibung |
|---|
cnStateInactive | 0 | Die Datenmenge ist inaktiv und nicht verwendbar |
cnStateUnknown | 1 | Der Status ist nicht zu ermitteln |
cnStateEditing | 2 | Der aktuelle Datensatz wird editiert (nach Aufruf von Edit) |
cnStateBrowsing | 3 | Die Menge befindet sich im Blättermodus. First, Next, Prior und Last sind möglich |
cnStateInserting | 4 | Ein Datensatz wird eingefügt (nach Append) |
cnStateSearchEditing | 5 | Der Suchmodus ist aktiv (nach Search). Über Values(Feldname) kann der Suchtext hinterlegt werden |
Beispiele
#
Adress-Suche
#
In diesem Beispiel wird eine neue Adress-Datenmenge erzeugt und Telefonnummern aus Wiesbaden gesucht. Falls entsprechende Adressen gefunden wurden, wird der erste Matchcode angezeigt.
Option Explicit
Dim ds
Set ds = Client.CreateDataset("Eulanda.Adresse")
ds.Search
ds.Values("Tel") = "0611-*"
ds.Post
If ds.EOF Then
ellib.ShowMessage "Es sind keine Adressen mit Wiesbadener Vorwahl vorhanden"
Else
ellib.ShowMessage CStr(ds.Values("Match"))
End If
Durch alle Datensätze blättern
#
Option Explicit
Dim ds, anzahl
Set ds = Client.CreateDataset("Eulanda.Artikel")
ds.Search
ds.Post
anzahl = 0
Do While Not ds.EOF
anzahl = anzahl + 1
ds.Next
Loop
ellib.ShowMessage "Anzahl Artikel: " & CStr(anzahl)
Verknüpfung auf dem Desktop speichern
#
Dim WshShell, DesktopFolder, LinkFile
Set WshShell = CreateObject("WScript.Shell")
DesktopFolder = WshShell.SpecialFolders("Desktop")
LinkFile = DesktopFolder & "\Verknüpfung.cnlnk"
Dataset.SaveCurrentLink LinkFile
Siehe auch
#