Record-Objekt | (Versionen 2.5, 2.6) |
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 |
|