Datensätze und Provider-Supplied Felder
Wenn ein Record-Objekt geöffnet wird, kann es sich bei der Quelle um die aktuelle Zeile eines geöffneten Recordset, einer absoluten URL oder einer relativen URL in Verbindung mit einem geöffneten Connection-Objekt handeln.
Wenn das Record aus einem Recordsetgeöffnet wird, enthält die Fields-Sammlung des Record-Objekts alle Felder aus dem Recordsetsowie alle Felder, die vom zugrunde liegenden Anbieter hinzugefügt wurden.
Der Anbieter kann zusätzliche Felder einfügen, die als ergänzende Merkmale des Datensatzesdienen. Daher kann ein Datensatz über eindeutige Felder verfügen, die weder im Recordset insgesamt noch in einem anderen Datensatz vorkommen, der aus einer anderen Zeile des Recordsetabgeleitet ist.
Beispielsweise können alle Zeilen eines Recordset, die von einer E-Mail-Datenquelle abgeleitet wurden, Spalten wie "Von", "An" und "Betreff" aufweisen. Ein Record-, der von diesem Recordset- abgeleitet ist, enthält dieselben Felder. Der Datensatz- kann jedoch auch andere Felder enthalten, die für die spezifische Nachricht einzigartig sind, die durch diesen Datensatzdargestellt wird, wie z. B. Anhang und Cc (Kopie).
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 aufweisen.
Ein gemeinsames Feld von Record und Recordset kann in beiden Objekten geändert werden. Das Feld kann jedoch nicht für das Record-Objekt gelöscht werden, obwohl der zugrunde liegende Anbieter das Festlegen des Felds auf NULL unterstützen kann.
Nachdem das Datensatz- geöffnet wurde, können Sie programmgesteuert Felder hinzufügen. Sie können felder, die Sie hinzugefügt haben, löschen, aber Sie können 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 dem 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 durch die Recorddargestellt wird. Wenn die Entität aus einem Bytestrom besteht, z. B. einer einfachen Datei, kann ein Stream-Objekt in der Regel aus dem Recordgeöffnet werden.
Spezielle Felder für Dokumentquellenanbieter
Eine spezielle Anbieterklasse, die Anbieter von Dokumentquellengenannt wird, verwaltet Ordner und Dokumente. Wenn ein Record -Objekt ein Dokument oder ein Recordset- -Objekt einen Ordner mit Dokumenten darstellt, füllt der Dokumentquellenanbieter diese Objekte mit einem eindeutigen Satz von Feldern auf, die Merkmale des Dokuments beschreiben, anstatt das eigentliche Dokument selbst. In der Regel enthält ein Feld einen Verweis auf den Stream , der das Dokument darstellt.
Diese Felder stellen eine Ressource Datensatz oder Recordset- dar und werden für die spezifischen Anbieter aufgeführt, die sie in Anhang A: Anbieterunterstützen.
Zwei Konstanten indizieren die Fields Auflistung einer Ressource Record oder Recordset, um ein Paar häufig verwendeter Felder abzurufen. Das Field-Objekt Value-Eigenschaft 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 identifiziert.
Ein Dokumentquellanbieter unterstützt nicht die Properties Auflistung von Record und Field Objekten. Der Inhalt der Properties -Auflistung ist null für solche Objekte.
Ein Dokumentquellanbieter kann eine anbieterspezifische Eigenschaft wie Datentyp hinzufügen, um zu ermitteln, ob es sich um einen Dokumentquellanbieter handelt. Weitere Informationen zum Ermitteln Ihres Anbietertyps finden Sie in der Dokumentation ihres Anbieters.
Ressourcen-Datensatz-Spalten
Ein Ressourcen-Datensatz besteht aus den folgenden Spalten.
| Spaltenname | Typ | 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, bei der es sich um die Verkettung von PARENTNAME und PARSENAME handelt. |
| RESOURCE_ISHIDDEN | AdBoolean | Wahr, wenn die Ressource ausgeblendet ist. Es werden keine Zeilen zurückgegeben, es sei denn, der Befehl, der das Rowset erstellt, wählt explizit Zeilen aus, wobei RESOURCE_ISHIDDEN "True" ist. |
| RESSOURCE_ISTSCHREIBGESCHÜTZT | 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 kann der Office-Vorlage entsprechen, die zum Erstellen des Dokuments verwendet wurde. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Gibt den MIME-Typ des Dokuments an, der das Format angibt, z. B. "text/html". |
| Ressourceninhaltssprache | AdVarWChar | Gibt die Sprache an, in der der Inhalt gespeichert wird. |
| RESSOURCENERSTELLUNGSZEIT | adFileTime | Schreibgeschützt. Gibt eine FILETIME-Struktur an, die die Erstellungszeit der Ressource enthält. Die Uhrzeit wird im UTC-Format (Coordinated Universal Time) gemeldet. |
| RESOURCE_ZULETZTBENUTZTZEIT | AdFileTime | Schreibgeschützt. Gibt eine FILETIME-Struktur an, die den Zeitpunkt enthält, zu dem zuletzt auf die Ressource zugegriffen wurde. Die Uhrzeit ist im UTC-Format. Die FILETIME-Member sind null, wenn der Anbieter dieses Zeitmitglied nicht unterstützt. |
| RESSOURCE_LETZTESCHREIBZEIT | AdFileTime | Schreibgeschützt. Gibt eine FILETIME-Struktur an, die die Uhrzeit enthält, zu der die Ressource zuletzt geschrieben wurde. Die Uhrzeit ist im UTC-Format. Die FILETIME-Mitglieder haben den Wert Null, wenn der Anbieter dieses Mitglied nicht unterstützt. |
| RESOURCE_STREAMSIZE | alsUnsignierteGroßzahl | Schreibgeschützt. Gibt die Größe des Standarddatenstroms der Ressource in Byte an. |
| RESSOURCE_ISTSAMMLUNG | AdBoolean | Schreibgeschützt. True, wenn es sich bei der Ressource um eine Auflistung handelt, z. B. ein Verzeichnis. False, wenn es sich bei der Ressource um eine einfache Datei handelt. |
| RESOURCE_ISSTRUCTUREDDOCUMENT | AdBoolean | True, wenn die Ressource ein strukturiertes Dokument ist. False, wenn die Ressource kein strukturiertes Dokument ist. Es kann sich um eine Sammlung oder eine einfache Datei sein. |
| STANDARD_DOKUMENT | AdVarWChar | Schreibgeschützt. Gibt an, dass diese Ressource eine URL zum standard 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. |
| Kapitelweise unterteilte Kinder | WerbeKapitel | Schreibgeschützt. Wahlfrei. Gibt das Kapitel des Rowsets 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. Gibt den Anzeigenamen der Ressource an. |
| RESOURCE_ISTWURZEL | AdBoolean | Schreibgeschützt. True, wenn die Ressource der Stamm einer Auflistung oder eines strukturierten Dokuments ist. |