Microsoft Office Access 2007-Programmierung - Das Handbuch

Eigenschaft Bedeutung

CommandType Typ des Command-Objekts (adCmdUnknown, adCmdText, adCmdTable, adCmdStoredProc, adCommandFile)

Prepared True, falls eine kompilierte Version des Befehls vor dessen Ausführung gespeichert werden soll

State Objektstatus (adStateClosed, adStateOpen), Read-only

Tabelle 7.15 Eigenschaften des Command-Objekts (Fortsetzung)

Methode Ausgeführte Operation

Cancel Bricht Ausführung eines asynchronen Aufrufs der Execute- oder Open-Methode ab

CreateParameter Erstellt neues Parameter-Objekt (opt. Parameter: Name, Type, Direction, Size, Value)

Execute Führt Abfrage, SQL-Anweisung oder Stored Procedure lt. CommandText-Eigenschaft aus (optionale Para-

meter: RecordsAffected, Parameters, Options)

Tabelle 7.16 Methoden des Command-Objekts

Recordset-Objekt

Eigenschaft Bedeutung

AbsolutePage Seite, auf welcher der aktuelle Datensatz gespeichert ist: 1... PageCount

AbsolutePosition Ordinalposition des aktuellen Datensatzes: adPosUnknown, adPosBOF, adPosEOF

ActiveConnection Zugeordnetes Connection-Objekt

BOF und EOF True, wenn sich aktueller Datensatzzeiger vor der ersten oder nach der letzten Zeile befindet

Bookmark Lesezeichen zur eindeutigen Kennzeichnung des aktuellen Datensatzes

CacheSize Anzahl der lokal zwischengespeicherten Datensätze

CursorLocation Position des Cursormoduls: adUseNone, adUseServer, adUseClient

CursorType Cursortyp: adOpenForwardOnly, adOpenKeyset, adOpenDynamic, adOpenStatic

EditMode Bearbeitungsstatus des akt. Datensatzes (Read-only): adEditNone, adEditInProgress, adEditAdd,

adEditDelete

Filter Variant-Wert zum Ausblenden von Datensätzen: Zeichenfolge, Bookmark-Array oder Konstante wie

adFilterAffectedRecords, adFilterFetchedRecords etc. rückgängig mit adFilterNone

LockType Art des Sperrens von Datensätzen: adLockReadOnly, adLockPessimistic, adLockOptimistic, adLockBatch-

Optimistic

MarshalOptions Art der Datensätze, die durch Marshaling an Server übertragen werden: adMarshalAll, adMarshal-

ModifiedOnly

MaxRecords Maximale Anzahl von Datensätzen, die als Ergebnis einer Abfrage vom Provider zurückgeliefert werden

sollen

PageCount Anzahl der Datenseiten im Recordset

PageSize Anzahl der Datensätze pro Seite

Tabelle 7.17 Eigenschaften des Recordset-Objekts

397

Übersichten

Kapitel 7: ADO-Programmierung

Eigenschaft Bedeutung

RecordCount Aktuelle Anzahl von Datensätzen

Sort Zeichenkette mit Feldnamen (durch Komma getrennt), nach denen im Recordset sortiert wird

Source Zeichenkette (Read-only), die Datenquelle des Recordset angibt: Command-Objekt, SQL-Zeichenkette,

Tabellenname, Stored Procedure

State Aktueller Status beim Ausführen einer asynchronen Methode (Read-only): adStateClosed, adStateOpen,

adStateConnecting

Status Status des aktuellen Datensatzes bezüglich Stapelaktualisierungen etc. (Read-only): adRecOK, adRecNew,

adRecModified, adRecDeleted, adRecUnmodified, adRecInvalid, adRecPermissionDenied etc.

Tabelle 7.17 Eigenschaften des Recordset-Objekts (Fortsetzung)

Methode Operation

AddNew Erstellt einen neuen Datensatz, falls Recordset aktualisierbar ist: [FieldList, Values]

Cancel Beendet die Ausführung eines asynchronen Aufrufs der Execute- oder Open-Methode

CancelBatch Bricht die bevorstehende Stapelaktualisierung ab: [AffectRecords] = adAffectCurrent, adAffectGroup,

adAffectAll

CancelUpdate Verwirft Änderungen, die vor Aufruf der Update-Methode vorgenommen wurden

Clone Erstellt ein neues Recordset-Objekt als Duplikat ( [adLockUnspecified], [adLockReadOnly])

Delete Löscht den aktuellen Datensatz oder eine Gruppe: [AffectRecords] = adAffectCurrent, adAffectGroup

Find Sucht den nächstliegenden Datensatz, der einem Kriterium entspricht: Criteria [Offset, Direction, Bookmark]

GetString Liefert den Recordset als Zeichenfolge zurück: StringFormat [NumRows, ColumnDelimiter, RowDelimiter,

NullExpr]

Move Verschiebt die Position des aktuellen Datensatzes: NumRecords [Start]

MoveFirst, MoveLast,

MoveNext, MovePrevious

Wechselt zum ersten, letzten, nächsten und vorhergehenden Datensatz

NextRecordset Löscht das aktuelle Recordset-Objekt und liefert das nächste (für zusammengesetzte Befehlsanweisungen oder

Stored Procedures)

Open Öffnet einen Cursor: Source, [ActiveConnection, CursorType, LockType, Options]

Requery Aktualisiert den Recordset durch erneutes Ausführen der zugrunde liegenden Abfrage

Resync Aktualisiert den Recordset mit den Daten der zugrunde liegenden Datenbank: AffectRecords, ResyncValues

Save Speichert den Recordset in eine Datei: FileName [PersistFormat]

Supports Bestimmt, ob der Recordset einen bestimmten Funktionstyp unterstützt: CursorOptions = adAddNew, adBook-

mark, adDelete, adUpdate etc.

Update Speichert alle vorgenommenen Änderungen: [Fields, Values]

UpdateBatch Speichert alle anstehenden Stapelaktualisierungen in die Datenbank: [AffectRecords]

Tabelle 7.18 Methoden des Recordset-Objekts

398