Record-Objekt (ADO)
Stellt eine Zeile aus einem Recordset oder dem Datenanbieter oder einem Objekt dar, das von einem halbstrukturierten Datenanbieter zurückgegeben wird, z. B. einer Datei oder einem Verzeichnis.
Bemerkungen
Ein Record-Objekt stellt eine Datenzeile dar und weist einige konzeptionelle Ähnlichkeiten mit einem einzeilen Recordset-auf. Je nach den Funktionen Ihres Anbieters werden Record-Objekte möglicherweise direkt von Ihrem Anbieter zurückgegeben, anstatt ein einzeilen Recordset-, z. B. wenn eine SQL-Abfrage ausgeführt wird, die nur eine Zeile auswählt. Oder ein Record-Objekt kann direkt aus einem Recordset-Objekt abgerufen werden. Oder ein Record kann direkt von einem Anbieter an halbstrukturierte Daten zurückgegeben werden, z. B. der Microsoft Exchange OLE DB-Anbieter.
Sie können die dem Record-Objekt zugeordneten Felder mithilfe der Fields-Auflistung für das Record-Objekt anzeigen. ADO ermöglicht objektwertige Spalten, einschließlich Recordset-, SafeArray-und Skalarwerte in der Fields -Auflistung von Record-Objekten.
Wenn das Record-Objekt eine Zeile in einem Recordset-darstellt, ist es möglich, mit der Source-Eigenschaft zu diesem ursprünglichen Records et-Objekt zurückzukehren.
Das Record-Objekt kann auch von semistrukturierten Datenanbietern wie dem Microsoft OLE DB-Anbieter für Internet Publishingverwendet werden, um strukturstrukturstrukturierte Namespaces zu modellieren. Jeder Knoten in der Struktur ist ein Record-Objekt mit zugeordneten Spalten. Die Spalten können die Attribute dieses Knotens und andere relevante Informationen darstellen. Das Record-Objekt kann sowohl einen Blattknoten als auch einen Nicht-Blattknoten in der Struktur darstellen. Nicht-Blattknoten weisen andere Knoten als Inhalt auf, aber Blattknoten haben solche Inhalte nicht. Blattknoten enthalten in der Regel binäre Datenströme und nicht blattfreie Knoten können auch einen standardmäßigen binären Datenstrom zugeordnet haben. Eigenschaften für das Record-Objekt identifizieren den Knotentyp.
Das Record-Objekt stellt auch eine alternative Methode zum Navigieren hierarchisch organisierter Daten dar. Ein Record-Objekt kann erstellt werden, um den Stamm einer bestimmten Unterstruktur in einer großen Struktur darzustellen, und neue Record-Objekte können geöffnet werden, um untergeordnete Knoten darzustellen.
Eine Ressource (z. B. eine Datei oder ein Verzeichnis) kann durch eine absolute URL eindeutig identifiziert werden. Ein Connection-Objekt wird implizit erstellt und auf das Record-Objekt festgelegt, wenn das Record- mithilfe einer absoluten URL geöffnet wird. Ein Connection-Objekt kann über die ActiveConnection- eigenschaft explizit auf das Record-Objekt festgelegt werden. Auf die Dateien und Verzeichnisse, auf die mithilfe des Connection-Objekts zugegriffen werden kann, wird der Kontext definiert, in dem Record-Vorgänge auftreten können.
Datenänderungs- und Navigationsmethoden für das Record-Objekt akzeptieren auch eine relative URL, die eine Ressource mithilfe einer absoluten URL oder des Connection Objektkontexts als Ausgangspunkt findet.
Anmerkung
URLs, die das HTTP-Schema verwenden, rufen automatisch den Microsoft OLE DB-Anbieter für Internet Publishingauf. Weitere Informationen finden Sie unter absoluten und relativen URLs.
Jedem Record-Objekt ist ein Connection-Objekt zugeordnet. Daher können Datensatz--Objektvorgänge Teil einer Transaktion sein, indem sie Connection Objekttransaktionsmethoden aufrufen.
Das Record-Objekt unterstützt keine ADO-Ereignisse und reagiert daher nicht auf Benachrichtigungen.
Mit den Methoden und Eigenschaften eines Record-Objekts können Sie folgende Aktionen ausführen:
Festlegen oder Zurückgeben des zugeordneten Connection-Objekts mit der ActiveConnection-Eigenschaft.
Geben Sie Zugriffsberechtigungen mit der eigenschaft Mode an.
Geben Sie ggf. die URL des Verzeichnisses zurück, die die Ressource enthält, die durch den Record mit der ParentURL- eigenschaft dargestellt wird.
Geben Sie die absolute URL, relative URL oder Recordset- an, von der das Record mit der eigenschaft Source abgeleitet wird.
Geben Sie den aktuellen Status des Record- mit der eigenschaft State an.
Geben Sie den Typ von Record - einfachen, Auflistungoder strukturierten Dokument - mit der eigenschaft RecordType an.
Beenden Sie die Ausführung eines asynchronen Vorgangs mit der Cancel-Methode.
Trennen Sie die Zuordnung des Record aus einer Datenquelle mit der Close-Methode.
Kopieren Sie die Datei oder das Verzeichnis, dargestellt durch einen Record an einen anderen Speicherort mit der CopyRecord-Methode.
Löschen Sie die Datei oder Verzeichnis- und Unterverzeichnisse, dargestellt durch einen Record mit der DeleteRecord-Methode.
Öffnen Sie ein Recordset-, das Zeilen enthält, die die Unterverzeichnisse und Dateien der Entität darstellen, die durch die Record mit der GetChildren-Methode dargestellt wird.
Verschieben (Umbenennen) der Datei oder des Verzeichnisses und Unterverzeichnisses, dargestellt durch einen Record an einen anderen Speicherort mit der MoveRecord-Methode.
Ordnen Sie den Record einer vorhandenen Datenquelle zu, oder erstellen Sie eine neue Datei oder ein neues Verzeichnis mit der Open-Methode.
Das Record-Objekt ist für Skripts sicher.
Dieser Abschnitt enthält das folgende Thema.
Siehe auch
Fields-Auflistung (ADO)
Properties-Auflistung (ADO)
Datensätze und Datenströme
Recordset-Objekt (ADO)