Datensätze und von Anbietern bereitgestellte Felder
Wenn ein Record-Objekt geöffnet wird, kann seine Quelle die aktuelle Zeile eines geöffneten Recordset, eine absolute URL oder eine relative URL in Verbindung mit einem geöffneten Connection-Objekt sein.
Wenn der Record über ein Recordset geöffnet wird, enthält die Fields-Sammlung des Record-Objekts alle Felder des Recordset sowie sämtliche Felder, die vom zugrunde liegenden Anbieter hinzugefügt wurden.
Der Anbieter kann zusätzliche Felder einfügen, die als zusätzliche Merkmale des Record dienen. Daher hat ein Record möglicherweise keine eindeutigen Felder im Recordset als Ganzes oder einen Record, der aus einer anderen Zeile des Recordset abgeleitet wurde.
Beispielsweise können alle Zeilen eines Recordset, das aus einer E-Mail-Datenquelle abgeleitet wurde, Spalten wie „Von“, „An“ und „Betreff“ aufweisen. Ein Record, der aus diesem Recordset abgeleitet ist, verfügt über dieselben Felder. Der Record kann jedoch auch andere eindeutige Felder für die bestimmte Nachricht haben, die von diesem Record dargestellt werden, z. B. Anlage und Cc (Carbon Copy).
Obwohl das Record-Objekt und die aktuelle Zeile des Recordset dieselben Felder aufweisen, sind sie unterschiedlich, da Record- und Recordset-Objekte unterschiedliche Methoden und Eigenschaften haben.
Ein gemeinsam von Record und Recordset verwendetes Feld kann in jedem der beiden Objekte bearbeitet werden. Das Feld kann jedoch nicht im Record-Objekt gelöscht werden, auch wenn der zugrunde liegende Anbieter für das Feld den Wert „Null“ einstellen kann.
Nach dem Öffnen von Record können Sie Felder programmgesteuert hinzufügen. Sie können auch Felder löschen, die Sie hinzugefügt haben, Sie können jedoch keine Felder aus dem ursprünglichen Recordset löschen.
Sie können das Record-Objekt auch direkt über eine URL öffnen. In diesem Fall hängen die Felder, die Record hinzugefügt wurden, vom zugrunde liegenden Anbieter ab. Derzeit fügen die meisten Anbieter eine Reihe von Feldern hinzu, die die Entität beschreiben, die von Record dargestellt wird. Wenn die Entität aus einem Bytedatenstrom besteht, z. B. einer einfachen Datei, kann ein Stream-Objekt in der Regel aus dem Record geöffnet werden.
Spezielle Felder für Dokumentquellenanbieter
Eine spezielle Klasse von Anbietern namens Dokumentquellenanbieter, die Ordner und Dokumente verwaltet. Wenn ein Record-Objekt ein Dokument oder ein Recordset-Objekt einen Ordner von Dokumenten darstellt, füllt der Dokumentquellenanbieter diese Objekte mit einem eindeutigen Satz von Feldern, die die Merkmale des Dokuments und nicht das eigentliche Dokument beschreiben. Normalerweise enthält ein Feld einen Verweis auf den Stream, der das Dokument darstellt.
Diese Felder bilden einen Record oder ein Recordset für Ressourcen und werden für die spezifischen Anbieter aufgeführt, die sie in Anhang A: Anbieter unterstützen.
Zwei Konstanten indexieren die Fields-Sammlung eines Record oder Recordset für Ressourcen, um ein paar häufig verwendete Felder abzurufen. Die Value-Eigenschaft des Field-Objekts gibt den gewünschten Inhalt zurück.
Das Feld, auf das mit der adDefaultStream-Konstante zugegriffen wird, enthält einen Standarddatenstrom, der dem Record- oder Recordset-Objekt zugeordnet ist. Der Anbieter weist einem Objekt einen Standarddatenstrom zu.
Das Feld, auf das mit der adRecordURL-Konstante zugegriffen wird, enthält die absolute URL, die das Dokument kennzeichnet.
Ein Dokumentquellenanbieter unterstützt die Properties-Sammlung von Record- und Field-Objekten nicht. Der Inhalt der Properties-Sammlung ist für derartige Objekte null.
Ein Dokumentquellenanbieter kann eine anbieterspezifische Eigenschaft wie den Datenquellentyp hinzufügen, um festzustellen, ob es sich um einen Dokumentquellenanbieter handelt. Weitere Informationen zum Ermitteln Ihres Anbietertyps finden Sie in Ihrer Anbieterdokumentation.
Spalten für Ressourcendatensätze
Ein Recordset für Ressourcen besteht aus den folgenden Spalten.
| Spaltenname | type | Beschreibung |
|---|---|---|
| RESOURCE_PARSENAME | AdVarWChar | Schreibgeschützt. Gibt die URL der Ressource an. |
| RESOURCE_PARENTNAME | AdVarWChar | Schreibgeschützt. Gibt die absolute URL des übergeordneten Datensatzes an. |
| RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | Schreibgeschützt. Gibt die absolute URL der Ressource an, die die Verkettung von PARENTNAME und PARSENAME ist. |
| RESOURCE_ISHIDDEN | AdBoolean | True, wenn die Ressource ausgeblendet ist. Es werden keine Zeilen zurückgegeben, solange der Befehl, der das Rowset erstellt, nicht explizit Zeilen auswählt, in denen RESOURCE_ISHIDDEN True ist. |
| RESOURCE_ISREADONLY | AdBoolean | True, wenn die Ressource schreibgeschützt ist. Versucht, diese Ressource mit DBBINDFLAG_WRITE zu öffnen, und schlägt mit DB_E_READONLY fehl. Diese Eigenschaft kann auch bearbeitet werden, wenn die Ressource nur zum Lesen geöffnet wurde. |
| RESOURCE_CONTENTTYPE | AdVarWChar | Gibt die wahrscheinliche Verwendung des Dokuments an, z. B. einen Anwaltsbrief. Dies entspricht möglicherweise der Office-Vorlage, die zum Erstellen des Dokuments verwendet wurde. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Gibt den MIME-Typ des Dokuments an, der das Format „text/html“ angibt. |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Gibt die Sprache an, in der der Inhalt gespeichert wird. |
| RESOURCE_CREATIONTIME | adFileTime | Schreibgeschützt. Gibt eine FILETIME-Struktur an, die die Zeit enthält, zu der die Ressource erstellt wurde. Die Zeit muss im Format der koordinierten Weltzeit angegeben werden. |
| RESOURCE_LASTACCESSTIME | AdFileTime | Schreibgeschützt. Gibt eine FILETIME-Struktur an, die die Zeit enthält, zu der die Ressource zuletzt aufgerufen wurde. Die Zeit ist im Format der koordinierten Weltzeit angegeben. Die FILETIME-Elemente sind null, wenn der Anbieter dieses Zeitelement nicht unterstützt. |
| RESOURCE_LASTWRITETIME | AdFileTime | Schreibgeschützt. Gibt eine FILETIME-Struktur an, die die Zeit enthält, zu der die Ressource zuletzt geschrieben wurde. Die Zeit ist im Format der koordinierten Weltzeit angegeben. Die FILETIME-Elemente sind null, wenn der Anbieter dieses Zeitelement nicht unterstützt. |
| RESOURCE_STREAMSIZE | asUnsignedBigInt | Schreibgeschützt. Gibt die Größe des Standarddatenstroms der Ressource in Bytes an. |
| RESOURCE_ISCOLLECTION | AdBoolean | Schreibgeschützt. True, wenn die Ressource eine Sammlung ist, z. B. ein Verzeichnis. False, wenn die Ressource eine einfache Datei ist. |
| RESOURCE_ISSTRUCTUREDDOCUMENT | AdBoolean | True, wenn die Ressource ein strukturiertes Dokument ist. Falls, wenn die Ressource kein strukturiertes Dokument ist. Es kann sich um eine Sammlung oder eine einfache Datei handeln. |
| DEFAULT_DOCUMENT | AdVarWChar | Schreibgeschützt. Gibt an, dass diese Ressource eine URL zum standardmäßigen einfachen Dokument eines Ordners oder eines strukturierten Dokuments enthält. Wird verwendet, wenn der Standarddatenstrom von einer Ressource angefordert wird. Diese Eigenschaft ist für eine einfache Datei leer. |
| CHAPTERED_CHILDREN | AdChapter | Schreibgeschützt. Optional. Gibt das Kapitel des Rowset an, das die untergeordneten Elemente der Ressource enthält. (Der OLE DB-Anbieter für Internet Publishing verwendet diese Spalte nicht.) |
| RESOURCE_DISPLAYNAME | AdVarWChar | Schreibgeschützt. Zeigt den Anzeigenamen der Ressource an. |
| RESOURCE_ISROOT | AdBoolean | Schreibgeschützt. True, wenn die Ressource der Stamm einer Sammlung oder eines strukturierten Dokuments ist. |