Partager via

Enregistrements et champs Provider-Supplied

Lorsqu’un objet Record est ouvert, sa source peut être la ligne actuelle d’un jeu d’enregistrements ouvert, une URL absolue ou une URL relative conjointement avec un objet Connection ouvert.

Si l’enregistrement est ouvert à partir d’un recordset, la collection Champs 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 qui servent de caractéristiques supplémentaires de l’enregistrement. Par conséquent, un enregistrement peut avoir des champs uniques qui ne sont pas dans l’ensemble de l’objet Recordset ou tout enregistrement dérivé d’une autre ligne du jeu d’enregistrements.

Par exemple, toutes les lignes d’un recordset dérivé d’une source de données de messagerie peuvent avoir des colonnes telles que From, To et Subject. Un enregistrement dérivé de ce jeu d’enregistrements aura les mêmes champs. Toutefois, l’enregistrement peut également avoir d’autres champs propres au message particulier représenté par cet enregistrement, tel que Pièce jointe et Cc (copie carbone).

Bien que l’objet Record et la ligne actuelle du jeu d’enregistrements aient les mêmes champs, ils sont différents, car les objets Record et Recordset ont des méthodes et des propriétés différentes.

Un champ en commun par l’objet Record et Recordset peut être modifié sur l’un ou l’autre des objets. Toutefois, le champ ne peut pas être supprimé sur l’objet Record , bien que le fournisseur sous-jacent puisse prendre en charge la définition du champ sur Null.

Une fois l’enregistrement ouvert, vous pouvez ajouter des champs par programmation. Vous pouvez également supprimer les champs que vous avez ajoutés, mais vous ne pouvez pas supprimer les champs depuis le jeu d’enregistrements d’origine.

Vous pouvez également ouvrir l’objet Record directement à partir d’une URL. Dans ce cas, les champs ajoutés à l’enregistrement 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’enregistrement. Si l’entité se compose d’un flux d’octets, tel qu’un fichier simple, un objet Stream peut généralement être ouvert à partir de l’enregistrement.

Champs spéciaux pour les fournisseurs de sources de documents

Une classe spéciale de fournisseurs, appelée fournisseurs de sources de documents, gère les dossiers et les documents. Lorsqu’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 qui décrivent les caractéristiques du document au lieu du document proprement dit. En règle générale, un champ contient une référence au flux qui représente le document.

Ces champs constituent un enregistrement de ressource ou un jeu d’enregistrements 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 Record ou Recordset de ressource pour récupérer une paire de champs souvent utilisés. La propriété Valeur 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 sources de documents ne prend pas en charge la collection Properties d’objets Record et Field . Le contenu de la collection Properties est null pour ces objets.

Un fournisseur de sources de documents peut ajouter une propriété spécifique au fournisseur, telle que le type de source de données , pour identifier s’il s’agit d’un fournisseur de source de documents. Pour plus d’informations sur la façon de déterminer votre type de fournisseur, consultez la documentation de votre fournisseur.

Colonnes d'enregistrements de ressources

Un ensemble d’enregistrements de ressources se compose des colonnes suivantes.

Nom de colonne Catégorie Descriptif
RESOURCE_PARSENAME AdVarWChar Lecture seule. Indique l’URL de la ressource.
NOM_PARENT_DE_LA_RESSOURCE 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_ESTENLECTURESEULE 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 la lecture.
TYPE_DE_CONTENU_RÉSOURCE AdVarWChar Indique l’utilisation probable du document, par exemple, le mémoire d’un avocat. Cela peut correspondre au modèle Office utilisé pour créer le document.
Ressource_ClasseDeContenu AdVarWChar Indique le type MIME du document, indiquant le format tel que «text/html ».
RESOURCE_CONTENTLANGUAGE AdVarWChar Indique la langue dans laquelle le contenu est stocké.
TEMPS_DE_CRÉATION_DE_LA_RESSOURCE adFileTime Lecture seule. Indique une structure FILETIME qui contient l’heure de création de la ressource. L’heure est signalée au format UTC (Temps universel coordonné).
RESOURCE_LASTACCESSTIME AdFileTime Lecture seule. Indique une structure FILETIME qui contient l’heure à laquelle la ressource a été consultée pour la dernière fois. L’heure est au format UTC. Les membres FILETIME sont à zéro si le fournisseur ne gère pas ce membre temporel.
RESOURCE_LASTWRITETIME AdFileTime Lecture seule. Indique une structure FILETIME qui contient l’heure à laquelle la ressource a été écrite pour la dernière fois. L’heure est au format UTC. Les membres FILETIME sont nuls si le fournisseur ne prend pas en charge cet élément temporel.
RESOURCE_STREAMSIZE enEntierNonSigné Lecture seule. Indique la taille du flux par défaut de la ressource, 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.
RESSOURCE_ESTDOCUMENTSTRUCTURÉ 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.
DOCUMENT_PAR_DÉFAUT AdVarWChar Lecture seule. Indique que cette ressource contient une URL vers le document simple par défaut d’un dossier ou d’un document structuré. Utilisé lorsque le flux par défaut est demandé à partir d’une ressource. Cette propriété est vide pour un fichier simple.
ENFANTS_CHAPITRES AdChapter Lecture seule. Optionnel. 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_RACINE AdBoolean Lecture seule. True si la ressource est la racine d’une collection ou d’un document structuré.

Voir aussi

Objet d'enregistrement (ADO)
Annexe A : Fournisseurs

  • Last updated on