Enregistrements et champs fournis par le fournisseur
Quand un objet Record est ouvert, sa source peut être la ligne active d’un objet Recordset ouvert, une URL absolue, ou une URL relative conjointement avec un objet Connection ouvert.
Si l’objet Record est ouvert à partir d’un objet Recordset, la collection Fields de l’objet Record contient tous les champs de l’objet Recordset, ainsi que tous les champs ajoutés par le fournisseur sous-jacent.
Le fournisseur peut insérer des champs supplémentaires faisant office de caractéristiques supplémentaires de l’objet Record. Par conséquent, un objet Record peut avoir des champs uniques ne figurant pas dans l’objet Recordset, ou n’importe quel objet Record dérivé d’une autre ligne de l’objet Recordset.
Par exemple, toutes les lignes d’un objet Recordset dérivé d’une source de données de courrier pourraient avoir des colonnes telles que De, À et Objet. Un objet Record dérivé de cet objet Recordset aura les mêmes champs. Toutefois, l’objet Record peut également avoir d’autres champs propres au message particulier représenté par cet objet Record, tels que Pièce jointe et Cc.
Bien que l’objet Record et la ligne active de l’objet Recordset aient les mêmes champs, ils diffèrent parce que les objets Record et Recordset ont des méthodes et propriétés différentes.
Un champ en commun aux objets Record et Recordset peut être modifié sur l’un ou l’autre objet. En revanche, le champ ne peut pas être supprimé sur l’objet Record, malgré que le fournisseur sous-jacent peut prendre en charge la définition du champ sur null.
Une fois l’objet Record ouvert, vous pouvez ajouter des champs par programmation. Vous pouvez également supprimer des champs que vous avez ajoutés, mais vous ne pouvez pas supprimer de champs de l’objet Recordset d’origine.
Vous pouvez également ouvrir l’objet Record directement à partir d’une URL. Dans ce cas, les champs ajoutés à l’objet Record dépendent du fournisseur sous-jacent. Actuellement, la plupart des fournisseurs ajoutent un ensemble de champs qui décrivent l’entité représentée par l’objet Record. Si l’entité consiste en un flux d’octets, tel qu’un fichier simple, un objet Stream peut généralement être ouvert à partir de l’objet Record.
Champs spéciaux pour les fournisseurs de sources de documents
Classe spéciale de fournisseurs, appelée fournisseurs de sources de documents, gère les dossiers et les documents. Quand un objet Record représente un document ou un objet Recordset représente un dossier de documents, le fournisseur de source de document remplit ces objets avec un ensemble unique de champs décrivant les caractéristiques du document, au lieu du document proprement dit. En règle générale, un champ contient une référence à l’objet Stream qui représente le document.
Ces champs constituent un objet Record ou Recordset de ressource, et sont répertoriés pour les fournisseurs spécifiques qui les prennent en charge dans l’Annexe A : Fournisseurs.
Deux constantes indexent la collection Fields d’un objet Record ou Recordset de ressource pour récupérer une paire de champs couramment utilisés. La propriété Value de l’objet Field retourne le contenu souhaité.
Le champ accessible avec la constante adDefaultStream contient un flux par défaut associé à l’objet Record ou Recordset. Le fournisseur affecte un flux par défaut à un objet.
Le champ accessible avec la constante adRecordURL contient l’URL absolue qui identifie le document.
Un fournisseur de source de document ne prend pas en charge la collection Properties d’objets Record et Field . Le contenu de la collection Properties est null pour de tels objets.
Un fournisseur de source de document peut ajouter une propriété spécifique du fournisseur, telle que Type de source de données, pour identifier s’il s’agit d’un fournisseur de source de document. Pour plus d’informations sur la façon de déterminer votre type de fournisseur, consultez la documentation de votre fournisseur.
Colonnes de Recordset de ressources
Un Recordset de ressources comprend les colonnes suivantes.
| Nom de la colonne | Type | Description |
|---|---|---|
| RESOURCE_PARSENAME | AdVarWChar | Lecture seule. Indique l’URL de la ressource. |
| RESOURCE_PARENTNAME | AdVarWChar | Lecture seule. Indique l’URL absolue de l’enregistrement parent. |
| RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | Lecture seule. Indique l’URL absolue de la ressource, qui est la concaténation de PARENTNAME et PARSENAME. |
| RESOURCE_ISHIDDEN | AdBoolean | True si la ressource est masquée. Aucune ligne ne sera retournée, sauf si la commande qui crée l’ensemble de lignes sélectionne explicitement les lignes où RESOURCE_ISHIDDEN a la valeur True. |
| RESOURCE_ISREADONLY | AdBoolean | True si la ressource est en lecture seule. Tente d’ouvrir cette ressource avec DBBINDFLAG_WRITE et échoue avec DB_E_READONLY. Cette propriété peut être modifiée même si la ressource n’a été ouverte que pour lecture. |
| RESOURCE_CONTENTTYPE | AdVarWChar | Indique l’utilisation probable du document, par exemple, mémoire d’avocat. Elle peut correspondre au modèle Office utilisé pour créer le document. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Indique le type MIME du document, avec le format tel que « text/html ». |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Indique la langue dans laquelle le contenu est stocké. |
| RESOURCE_CREATIONTIME | adFileTime | Lecture seule. Indique une structure FILETIME contenant l’heure de création de la ressource. L’heure est indiquée au format de temps universel coordonné (UTC). |
| RESOURCE_LASTACCESSTIME | AdFileTime | Lecture seule. Indique une structure FILETIME contenant l’heure de dernier accès à la ressource. L’heure est au format de temps universel coordonné (UTC). Les membres de FILETIME sont zéro si le fournisseur ne prend pas en charge ce membre de temps. |
| RESOURCE_LASTWRITETIME | AdFileTime | Lecture seule. Indique une structure FILETIME contenant l’heure de dernière écriture de la ressource. L’heure est au format de temps universel coordonné (UTC). Les membres de FILETIME sont zéro si le fournisseur ne prend pas en charge ce membre de temps. |
| RESOURCE_STREAMSIZE | asUnsignedBigInt | Lecture seule. Indique la taille du flux par défaut de la ressource, exprimée en octets. |
| RESOURCE_ISCOLLECTION | AdBoolean | Lecture seule. True si la ressource est une collection, telle qu’un répertoire. False si la ressource est un fichier simple. |
| RESOURCE_ISSTRUCTUREDDOCUMENT | AdBoolean | True si la ressource est un document structuré. False si la ressource n’est pas un document structuré. Il peut s’agir d’une collection ou d’un fichier simple. |
| DEFAULT_DOCUMENT | AdVarWChar | Lecture seule. Indique que cette ressource contient une URL du document simple par défaut d’un dossier ou d’un document structuré. Utilisée quand le flux par défaut est demandé à partir d’une ressource. Cette propriété est vide pour un fichier simple. |
| CHAPTERED_CHILDREN | AdChapter | Lecture seule. facultatif. Indique le chapitre de l’ensemble de lignes qui contient les enfants de la ressource (le Fournisseur OLE DB pour la publication Internet n’utilise pas cette colonne). |
| RESOURCE_DISPLAYNAME | AdVarWChar | Lecture seule. Indique le nom d’affichage de la ressource. |
| RESOURCE_ISROOT | AdBoolean | Lecture seule. True si la ressource est la racine d’une collection ou d’un document structuré. |