Record-Objekt (Versionen 2.5, 2.6)
Dim record As ADODB.Record

Das Objekt Record repräsentiert entweder eine einzelne Zeile in einem Recordset-Objekt oder eine Ressource in einer teilweise strukturierten Datenquelle (z. B. einem Dateiverzeichnis).

Record.ActiveConnection-Eigenschaft (Versionen 2.5, 2.6)

Record.ActiveConnection = ConnectionString
Set Record.ActiveConnection = ConnectionObject
 

Die Eigenschaft ActiveConnection zeigt, zu welchem Objekt Connection das aktuelle Record-Objekt gehört.

Datentyp

String oder Variante (die das aktuelle Connection-Objekt enthalten)

 
Beschreibung

Für die Eigenschaft ActiveConnection des Record-Objekts besteht sowohl Lese- als auch Schreibberechtigung, während das Objekt geschlossen ist. In geöffnetem Zustand ist es schreibgeschützt. Diese Eigenschaft kann auf einen Verbindungsstring oder ein Connection-Objekt festgelegt werden und gibt ein Connection-Objekt zurück, wenn sie gelesen wird.

Wenn das Objekt Record von einem bereits vorhandenen Objekt Record bzw. einem Objekt Recordset geöffnet wurde, erhält das Objekt Record sein Connection-Objekt von diesem Objekt. Wird das Objekt Record hingegen unter Verwendung einer URL geöffnet, wird automatisch ein Connection-Objekt für das Objekt Record erstellt, das über die Eigenschaft ActiveConnection zugänglich ist.

 
Siehe auch

Record.Open-Methode

 
Record.Cancel-Methode (Versionen 2.5, 2.6)

record.Cancel
 

Die Methode Cancel bricht einen asynchronen Vorgang für das Record-Objekt ab.

Beschreibung

Die Methode Cancel kann aufgerufen werden, um einen asynchronen Vorgang des Objekts Record abzubrechen, das von den Methoden CopyRecord, DeleteRecord, MoveRecord oder Open aufgerufen wurde.

 
Siehe auch

Record.CopyRecord-Methode, Record.DeleteRecord-Methode, Record.MoveRecord-Methode, Record.Open-Methode

 
Record.Close-Methode (Versionen 2.5, 2.6)

record.Close
 

Die Methode Close schließt ein geöffnetes Record-Objekt.

Beschreibung

Die Methode Close kann nur für ein geöffnetes Record-Objekt aufgerufen werden. Nach Aufruf der Methode Close kann die Methode Open erneut aufgerufen werden, um das Record-Objekt wieder zu öffnen. Durch Aufrufen der Methode Close werden alle dem Record-Objekt zugewiesenen Ressourcen freigegeben.

 
Record.CopyRecord-Methode (Versionen 2.5, 2.6)

record.CopyRecord (Source, _
Destination, _
UserName, _
Password, _
Options, _
Async) As String
 

CancelBatch ist eine Mitgliedsmethode des Objekts Recordset, die die gerade bevorstehende Batch-Aktualisierung abbricht.

Argumente
Source (String)

Optional. Zeigt die URL einer zu kopierenden Ressource an. Bei fehlendem Argument wird die Ressource kopiert, die vom aktuellen Objekt Record dargestellt wird.

Destination (String)

Optional. Repräsentiert einen URL-Wert, der angibt, wohin die Ressource kopiert wird.

UserName (String)

Optional. Gibt bei Bedarf den Benutzernamen an, der für den Zugriff auf die Ressource verwendet wird, die vom Argument Destination angegeben ist.

Password (String)

Optional. Gibt bei Bedarf das Kennwort zur Überprüfung des Arguments UserName an.

Options (CopyRecordOptionsEnum)

Optional. Gibt das Verhalten des kopierten Vorgangs an. Der Standardwert für dieses Argument ist adCopyUnspecified.

Async (Boolesch)

Optional. Gibt an, ob dieser Vorgang asynchron ausgeführt werden sollte.

 
Rückgabewerte

String

 
Beschreibung

Standardmäßig überschreibt die Methode CopyRecord eine bereits vorhandene Ressource nicht. Um eine Ersetzung der Zielressource zu erzwingen, verwenden Sie die Option adCopyOverWrite.

Standardmäßig kopiert die Methode CopyRecord alle Unterverzeichnisse und Dateien in der Quellressource, es sei denn, die Option adCopyNonRecursive ist angegeben.

Sind Quell- und Zielressourcen identisch, wird ein Fehler erzeugt. Wenn die Zielressource eine untergeordnete Ressource der Quellressource ist, wird der Vorgang nie abgeschossen.

Obwohl der Rückgabewert providerspezifisch ist, handelt es sich hierbei im Allgemeinen um den Namen der Zielressource.

 
Siehe auch

CopyRecordOptionsEnum-Enumeration

 
Record.DeleteRecord-Methode (Versionen 2.5, 2.6)

record.DeleteRecord Source, Async
 

Die Methode DeleteRecord löscht die Ressource, die durch das aktuelle Record-Objekt repräsentiert wird, bzw. ein anderes, wenn dieses angegeben ist.

Argumente
Source (String)

Optional. Gibt an, welche Ressource gelöscht werden soll. Bei fehlendem Argument wird die Ressource gelöscht, die vom aktuellen Objekt Record dargestellt wird.

Async (Boolesch)

Optional. Gibt an, ob dieser Vorgang asynchron ausgeführt werden sollte.

 
Beschreibung

Die Methode DeleteRecord löscht zusätzlich alle der aktuellen Ressource untergeordneten Ressourcen.

Das Objekt Record sollte sofort nach dem Aufruf der Methode DeleteRecord geschlossen werden, da sein Verhalten andernfalls nicht absehbar ist. Zumindest würde ein Fehler auftreten, wenn Sie versuchen, mit einem Record-Objekt zu arbeiten, das eine gelöschte Ressource darstellt.

Wenn das Objekt Record aus einem Recordset-Objekt erstellt wurde, sollten Sie das Objekt Recordset entweder schließen und erneut öffnen oder Resync bzw. Requery für die Ressource aufrufen, damit diese vom Objekt getrennt wird.

 
Siehe auch

Recordset.Open-Methode, Recordset.Requery-Methode, Recordset.Resync-Methode

 
Record.Fields-Kollektion (Versionen 2.5, 2.6)

record.Fields
 

Die Kollektion Fields enthält unabhängige Field-Objekte für das aktuelle Record-Objekt.

Datentyp

Fileds (Kollektionsobjekt)

 
Beschreibung

Die Kollektion Fields enthält mehrere Field-Objekte für das aktuelle Record-Objekt. Es gibt zwei spezielle Field-Objekte, adDefaultStream und adRecordURL, auf die über die Angabe der Enumeration FieldEnum zugegriffen werden kann. Das eine Objekt gibt den Standardstring für das aktuelle Record-Objekt zurück, das andere die URL.

Field-Objekte können der Kollektion entweder durch Aufrufen der Methode Field.Append hinzugefügt werden oder durch Verweisen auf ein Feld über einen Namen, der nicht bereits Teil der Kollektion ist. Durch Aufrufen der Methode Field.Update wird der Kollektion das Feld hinzugefügt; wenn möglich innerhalb der Datenquelle. Bis zu diesem Zeitpunkt gibt die Eigenschaft Field.Status den Wert adFieldPendingInsert zurück.

 
Siehe auch

Field.Append-Methode, Field.Update-Methode, FieldEnum-Enumeration

 
Record.GetChildren-Methode (Versionen 2.5, 2.6)

Set recordset = record.GetChildren
 

Die Methode GetChildren gibt die untergeordneten Objekte einer Record-Objektkollektion in Form eines Recordset-Objekts zurück.

Rückgabewerte

Objekt Recordset

 
Beschreibung

Die Methode GetChildren gibt ein Recordset-Objekt zurück, das untergeordnete Objekte des aktuellen Objekts Record enthält. Jeder Datensatz im zurückgegebenen Objekt Recordset stellt eine einzelne Ressource dar, die der Ressource untergeordnet ist, die vom zugeordneten Objekt Record repräsentiert wird.

 
Record.Mode-Eigenschaft (Versionen 2.5, 2.6)

record.Mode = ConnectModeEnum
 

Die Eigenschaft Mode zeigt die Berechtigungen zur Bearbeitung von Daten in einem Record-Objekt an.

Datentyp

ConnectModeEnum

 
Beschreibung

Der Standardwert für die Eigenschaft Mode eines Record-Objekts ist adModeRead. Für die Eigenschaft Mode besteht Lese- und Schreibberechtigung, während das Objekt Record geschlossen ist. In geöffnetem Zustand ist es schreibgeschützt.

 
Siehe auch

ConnectModeEnum-Enumeration

 
Record.MoveRecord-Methode (Versionen 2.5, 2.6)

record.MoveRecord (Source, _
Destination, _
UserName, _
Password, _
Options, _
Async) As String
 

Die Methode MoveRecord verschiebt eine Ressource an einen anderen Ort.

Argumente
Source (String)

Optional. Zeigt die URL einer zu verschiebenden Ressource an. Bei fehlendem Argument wird die Ressource verschoben, die vom aktuellen Objekt Record dargestellt wird.

Destination (String)

Optional. Repräsentiert einen URL-Wert, der angibt, wohin die Ressource verschoben wird.

UserName (String)

Optional. Gibt bei Bedarf den Benutzernamen an, der für den Zugriff auf die Ressource verwendet wird, die vom Argument Destination angegeben ist.

Password (String)

Optional. Gibt bei Bedarf das Kennwort zur Überprüfung des Arguments UserName an.

Options (CopyRecordOptionsEnum)

Optional. Gibt das Verhalten des Verschiebevorgangs an. Der Standardwert für dieses Argument ist adMoveUnspecified.

Async (Boolesch)

Optional. Gibt an, ob dieser Vorgang asynchron ausgeführt werden sollte.

 
Rückgabewerte

String

 
Beschreibung

Standardmäßig überschreibt die Methode MoveRecord eine bereits vorhandene Ressource nicht. Um eine Ersetzung der Zielressource zu erzwingen, verwenden Sie die Option adCopyOverWrite. Alle Hyperlinks in der Datei werden automatisch aktualisiert, es sei denn, im Argument Options ist etwas anderes angegeben.

Sind Quell- und Zielressourcen identisch, wird ein Fehler erzeugt.

Wenn das Objekt Record aus einem Recordset-Objekt erstellt wurde, sollten Sie das Objekt Recordset entweder schließen und erneut öffnen oder Resync bzw. Requery für die Ressource aufrufen, damit diese vom Objekt Recordset getrennt wird.

Nicht alle Eigenschaften des Objekts Record werden automatisch wieder mit Daten gefüllt. Um dies zu erreichen, schließen Sie das Objekt Record, und öffnen Sie es erneut.

Obwohl der Rückgabewert providerspezifisch ist, handelt es sich hierbei im Allgemeinen um den Namen der Zielressource.

 
Siehe auch

MoveRecordOptionsEnum-Enumeration, Record.Close-Methode, Record.Open-Methode, Recordset.Open-Methode, Recordset.Requery-Methode, Recordset.Resync-Methode

 
Record.Open-Methode (Versionen 2.5, 2.6)

record.Open (Source, _
ActiveConnection, _
Mode, _
CreateOptions, _
Options, _
UserName, _
Password)
 

Die Methode Open öffnet einen einzelnen Datensatz in einer Datensatzgruppe bzw. eine Ressource in einer Datenquelle.

Argumente
Source (Variante)

Optional. Gibt die Quelle der zu öffnenden Ressource an. Dies kann eine URL sein, ein Befehlsobjekt, das eine einzelne Zeile zurückgibt, ein offenes Recordset-Objekt oder ein String, der eine SQL-Anweisung oder einen Tabellennamen enthält.

ActiveConnection (Variante)

Optional. Gibt die Verbindung zur Datenquelle entweder durch einen Verbindungsstring oder ein offenes Connection-Objekt an.

Mode (ConnectModeEnum)

Optional. Gibt die Zugangsberechtigungen zum Öffnen des Objekts Record an. Der Standardwert ist adModeUnknown.

CreateOptions (CreateModeEnum)

Optional. Dieses Argument wird nur verwendet, wenn das Argument Source eine URL darstellt. Das Argument kann zur Angabe eingesetzt werden, ob eine bereits vorhandene Ressource geöffnet oder eine neue erstellt werden soll. Der Standardwert für dieses Argument ist adFailIfNotExist.

Options (RecordOpenOptionsEnum)

Optional. Kann mehrere Enumerationswerte RecordOpenOptionsEnum enthalten, die bestimmte Optionen für das Öffnen des Objekts Record angeben. Der Standardwert für diese Methode ist adOpenRecordUnspecified.

UserName (String)

Optional. Gibt bei Bedarf den Benutzernamen an, der für den Zugriff auf die Ressource verwendet wird, die vom Quellargument angegeben ist.

Password (String)

Optional. Gibt bei Bedarf das Kennwort zur Überprüfung des Arguments UserName an.

 
Beschreibung

Wenn das Objekt Record eine Ressource darstellt, die nicht durch eine URL repräsentiert werden kann, gibt die Eigenschaft ParentURL und das Standardfeld adRecordURL den Wert Null zurück.

 
Siehe auch

ConnectModeEnum-Enumeration, RecordCreateOptionsEnum-Enumeration, RecordOpenOptionsEnum-Enumeration

 
Record.ParentURL-Eigenschaft (Versionen 2.5, 2.6)

record.ParentURL = ParentURL
 

Die ParentURL wird zur Angabe des übergeordneten Datensatzes des aktuellen Objekts Record durch eine absolute URL verwendet.

Datentyp

String

 
Beschreibung

Die Eigenschaft ParentURL gibt die übergeordnete Ressource der durch das Objekt Record repräsentierten aktuellen Ressource an. Die Eigenschaft ist schreibgeschützt.

Die ParentURL kann Null sein, wenn keine übergeordnete Ressource für die durch das Objekt Record repräsentierte aktuelle Ressource vorhanden ist, oder wenn die Ressource nicht mittels einer URL ausgedrückt werden kann.

 
Record.Properties-Kollektion (Versionen 2.5, 2.6)

record.Properties
 

Die Kollektion Properties enthält Zeichen, die für das Objekt Record und den zurzeit verwendeten Provider spezifisch sind.

Datentyp

Eigenschaften (Kollektionsobjekt)

 
Beschreibung

Die Kollektionsklasse Properties enthält eine Klasseninstanz Property für jede Eigenschaft, die spezifisch für das Objekt Record und den Datenprovider ist.

 
Record.RecordType-Eigenschaft (Versionen 2.5, 2.6)

record.RecordType = RecordTypeEnum
 

Die Eigenschaft RecordType gibt den Typ des aktuellen Datensatzes an.

Datentyp

RecordTypeEnum

 
Beschreibung

Die Eigenschaft RecordType ist schreibgeschützt; sie gibt den Typ des aktuellen Objekts Record an.

 
Siehe auch

RecordTypeEnum-Enumeration

 
Record.Source-Eigenschaft (Versionen 2.5, 2.6)

Set record.Source = object
 

Die Eigenschaft Source gibt an, aus welchem Objekt das Objekt Record erstellt wurde.

Datentyp

Variante

 
Beschreibung

Die Eigenschaft Source ist schreibgeschützt, wenn das Objekt Record geöffnet ist; es besteht jedoch Lese- und Schreibberechtigung, wenn es geschlossen ist.

Die Eigenschaft Source kann auf ein Recordset- oder Command-Objekt festgelegt sein. Wenn die Eigenschaft Source auf ein Recordset-Objekt festgelegt ist, wird das Objekt Record abhängig vom aktuellen Datensatz des Objekts Recordset geöffnet. Ist die Eigenschaft Source hingegen auf ein Command-Objekt festgelegt, muss dieses eine einzelne Zeile zurückgeben.

Ist zusätzlich die Eigenschaft ActiveConnection festgelegt, muss die Eigenschaft Source auf ein Objekt eingestellt sein, das sich im Verbindungsbereich befindet.

Die Eigenschaft Source gibt das Argument Source der Methode Record.Open zurück.

 
Siehe auch

Record.ActiveConnection-Eigenschaft, Record.Open-Methode

 
Record.State-Eigenschaft (Versionen 2.5, 2.6)

state = record.State
 

Die Eigenschaft State gibt den aktuellen Status des Objekts Record an.

Datentyp

Long (ObjectStateEnum)

 
Beschreibung

Die schreibgeschützte Eigenschaft State gibt einen Long-Wert zurück, der als Enumerationswert ObjectStateEnum gewertet werden kann. Der Standardwert für das Objekt Record ist "geschlossen" (adStateClosed).

Für das Objekt Record kann die Eigenschaft State mehrere Werte zurückgeben, wenn das Objekt einen Vorgang asynchron ausführt (d. h. adStateOpen und adStateExecuting).

 
Siehe auch

ObjectStateEnum-Enumeration