Datensätze und vom Anbieter bereitgestellte Felder
Gilt für: Access 2013, Office 2013
Wenn ein Record-Objekt geöffnet wird, kann die Quelle die aktuelle Zeile eines geöffneten Recordsets, eine absolute URL oder eine relative URL in Verbindung mit einem geöffneten Connection-Objekt sein.
Wenn das Record -Objekt aus einem Recordset -Objekt geöffnet wird, enthält die Fields-Auflistung des Record -Objekts alle Felder aus dem Recordset sowie alle durch den zugrunde liegenden Anbieter hinzugefügten Felder.
Durch den Anbieter können zusätzliche Felder eingefügt werden, die als ergänzende Merkmale des Record -Objekts dienen. Daher verfügt ein Record -Objekt möglicherweise über eindeutige Felder, die im gesamten Recordset -Objekt oder in einem aus einer anderen Zeile des Recordset -Objekts abgeleiteten Record -Objekt nicht enthalten sind.
Beispielsweise können alle Zeilen eines Recordset-Objekts , das von einer E-Mail-Datenquelle abgeleitet wurde, Spalten wie From, To und Subject enthalten. A Record derived from that Recordset will have the same fields. However, the Record may also have other fields unique to the particular message represented by that Record, such as Attachment and Cc (carbon copy).
Obwohl das Record -Objekt und die aktuelle Zeile des Recordset -Objekts die gleichen Felder enthalten, unterscheiden sie sich, da die Objekte Record und Recordset über verschiedene Methoden und Eigenschaften verfügen.
Ein sowohl in Record als auch in Recordset enthaltenes Feld kann für jedes der Objekte geändert werden. Das Feld kann jedoch nicht für das Record -Objekt gelöscht werden, da vom zugrunde liegenden Anbieter möglicherweise das Festlegen des Felds auf Null unterstützt wird.
Nach dem Öffnen des Record -Objekts können Sie programmatisch Felder hinzufügen. Sie können auch hinzugefügte Felder löschen, Sie können jedoch keine Felder aus dem ursprünglichen Recordset -Objekt löschen.
Sie können das Record-Objekt auch direkt über eine URL öffnen. In diesem Fall hängen die dem Record-Objekt hinzugefügten Felder vom zugrunde liegenden Anbieter ab. Zurzeit wird durch die meisten Anbieter ein Satz Felder hinzugefügt, in denen die Entität beschrieben wird, die durch das Record-Objekt dargestellt wird. Wenn die Entität aus einem Bytedatenstrom besteht, z. B. aus einer einfachen Datei, kann ein Stream-Objekt normalerweise aus dem Record-Objekt geöffnet werden.
Spezielle Felder für Dokumentquellenanbieter
Mit einer speziellen Anbieterklasse, den Dokumentquellenanbietern, werden Ordner und Dokumente verwaltet. Wenn durch ein Record-Objekt ein Dokument dargestellt oder durch ein Recordset-Objekt ein Dokumentordner dargestellt wird, werden diese Objekte vom Dokumentquellenanbieter mit einem eindeutigen Satz Felder aufgefüllt, in dem die Merkmale des Dokuments anstelle des eigentlichen Dokuments selbst beschrieben sind. Normalerweise enthält ein Feld einen Verweis auf das Stream -Objekt, durch das das Dokument dargestellt wird.
Diese Felder stellen einen Ressourcen datensatz oder ein Recordset dar und werden in Anhang A: Anbieter für die Anbieter aufgelistet, von denen sie unterstützt werden.
Die Fields -Auflistung des Record - oder Recordset -Objekts einer Ressource wird von zwei Konstanten indiziert, um ein Paar häufig verwendeter Felder abzurufen. Durch die Value-Eigenschaft des Field -Objekts wird der gewünschte Inhalt zurückgegeben.
Das Feld, auf das mit der adDefaultStream -Konstante zugegriffen wird, enthält einen dem Record - oder Recordset -Objekt zugeordneten Standarddatenstrom. Dem Objekt wird vom Anbieter ein Standarddatenstrom zugewiesen.
Das Feld, auf das mit der adRecordURL -Konstante zugegriffen wird, enthält die absolute URL, durch die das Dokument identifiziert wird.
Die Properties-Auflistung der Objekte Record und Field wird von einem Dokumentquellenanbieter nicht unterstützt. Der Inhalt der Properties -Auflistung entspricht für solche Objekte Null.
Ein Dokumentquellenanbieter kann eine anbieterspezifische Eigenschaft hinzufügen, z. B. Datenquellentyp , um zu ermitteln, ob es sich um einen Dokumentquellenanbieter handelt. Weitere Informationen zum Ermitteln des Anbietertyps finden Sie in der Dokumentation zu Ihrem Anbieter.
Spalten von Ressourcenrecordsets
Ein Ressourcenrecordset besteht aus den folgenden Spalten.
Spaltenname |
Typ |
Beschreibung |
---|---|---|
RESOURCE_PARSENAME |
AdVarWChar |
Schreibgeschützt. Die URL der Ressource wird angegeben. |
RESOURCE_PARENTNAME |
AdVarWChar |
Schreibgeschützt. Die absolute URL des übergeordneten Datensatzes wird angegeben. |
RESOURCE_ABSOLUTEPARSENAME |
AdVarWChar |
Schreibgeschützt. Die absolute URL der Ressource, die der Verkettung von PARENTNAME und PARSENAME entspricht, wird angegeben. |
RESOURCE_ISHIDDEN |
AdBoolean |
True, wenn die Ressource ausgeblendet ist. Es werden nur Zeilen zurückgegeben, wenn durch den Befehl, durch den das Rowset erstellt wird, explizit Zeilen ausgewählt werden, bei denen RESOURCE_ISHIDDEN True entspricht. |
RESOURCE_ISREADONLY |
AdBoolean |
True, wenn die Ressource schreibgeschützt ist. Es wird versucht, diese Ressource mit DBBINDFLAG_WRITE zu öffnen, bei DB_E_READONLY schlägt der Vorgang fehl. Diese Eigenschaft kann auch dann bearbeitet werden, wenn die Ressource nur zum Lesen geöffnet wurde. |
RESOURCE_CONTENTTYPE |
AdVarWChar |
Die wahrscheinliche Verwendung des Dokuments wird angegeben - z. B. ein juristischer Schriftsatz. Sie kann der zum Erstellen des Dokuments verwendeten Office-Vorlage entsprechen."" |
RESOURCE_CONTENTCLASS |
AdVarWChar |
Gibt den MIME-Typ des Dokuments an und gibt das Format an, z. B. "text/html". |
RESOURCE_CONTENTLANGUAGE |
AdVarWChar |
Die Sprache, in der der Inhalt gespeichert wird, wird angegeben. |
RESOURCE_CREATIONTIME |
adFileTime |
Schreibgeschützt. Es wird eine FILETIME-Struktur angegeben, die die Uhrzeit der Erstellung der Ressource enthält. Die Uhrzeit wird im UTC-Format (Coordinated Universal Time, koordinierte Weltzeit) angegeben. |
RESOURCE_LASTACCESSTIME |
AdFileTime |
Schreibgeschützt. Es wird eine FILETIME-Struktur angegeben, die die Uhrzeit des letzten Zugriffs auf die Ressource enthält. Die Uhrzeit wird im UTC-Format angegeben. Die FILETIME-Elemente sind Null, wenn dieses Zeitelement vom Anbieter nicht unterstützt wird. |
RESOURCE_LASTWRITETIME |
AdFileTime |
Schreibgeschützt. Es wird eine FILETIME-Struktur angegeben, die die Uhrzeit des letzten Schreibvorgangs für die Ressource enthält. Die Uhrzeit wird im UTC-Format angegeben. Die FILETIME-Elemente sind Null, wenn dieses Zeitelement vom Anbieter nicht unterstützt wird. |
RESOURCE_STREAMSIZE |
asUnsignedBigInt |
Schreibgeschützt. Die Größe des Standarddatenstroms der Ressource wird in Byte angegeben. |
RESOURCE_ISCOLLECTION |
AdBoolean |
Schreibgeschützt. True, wenn die Ressource eine Auflistung, z. B. ein Verzeichnis, ist. False, wenn die Ressource eine einfache Datei ist. |
RESOURCE_ISSTRUCTUREDDOCUMENT |
AdBoolean |
True, wenn die Ressource ein strukturiertes Dokument ist. False, wenn die Ressource kein strukturiertes Dokument ist. Sie kann eine Auflistung oder eine einfache Datei sein. |
DEFAULT_DOCUMENT |
AdVarWChar |
Schreibgeschützt. Es wird angegeben, dass diese Ressource eine URL zum einfachen Standarddokument 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. Das Kapitel des Rowsets, das die untergeordneten Elemente der Ressource enthält, wird angegeben. (Vom OLE DB-Anbieter für Internet Publishing wird diese Spalte nicht verwendet.) |
RESOURCE_DISPLAYNAME |
AdVarWChar |
Schreibgeschützt. Der Anzeigename der Ressource wird angegeben. |
RESOURCE_ISROOT |
AdBoolean |
Schreibgeschützt. True, wenn die Ressource der Stamm einer Auflistung oder eines strukturierten Dokuments ist. |