Objet Record (ADO)

Représente une ligne à partir d’un recordset ou du fournisseur de données, ou d’un objet retourné par un fournisseur de données semi-structuré, tel qu’un fichier ou un répertoire.

Remarques

Un objet Record représente une ligne de données et présente des similitudes conceptuelles avec un recordset d’une ligne. Selon les fonctionnalités de votre fournisseur, les objets d’enregistrement peuvent être retournés directement à partir de votre fournisseur au lieu d’un jeu d’enregistrements d’une seule ligne, par exemple lorsqu’une requête SQL qui sélectionne une seule ligne est exécutée. Vous pouvez également obtenir un objet Record directement à partir d’un objet Recordset . Ou bien, un enregistrement peut être retourné directement d’un fournisseur à des données semi-structurées, telles que le fournisseur OLE DB Microsoft Exchange.

Vous pouvez afficher les champs associés à l’objet Record à l’aide de la collection Fields sur l’objet Record . ADO autorise les colonnes à valeur objet, notamment Recordset, SafeArray et les valeurs scalaires dans la collection Fields d’objets Record .

Si l’objet Record représente une ligne dans un recordset, il est possible de revenir à ce recordset d’origine avec la propriété Source .

L’objet Record peut également être utilisé par des fournisseurs de données semi-structurés, tels que le fournisseur Microsoft OLE DB pour la publication Internet, pour modéliser des espaces de noms structurés par arborescence. Chaque nœud de l’arborescence est un objet Record avec des colonnes associées. Les colonnes peuvent représenter les attributs de ce nœud et d’autres informations pertinentes. L’objet Record peut représenter à la fois un nœud feuille et un nœud non feuille dans l’arborescence. Les nœuds non-feuilles ont d’autres nœuds comme contenu, mais les nœuds feuilles n’ont pas ce contenu. Les nœuds feuilles contiennent généralement des flux binaires de données et des nœuds non feuilles peuvent également avoir un flux binaire par défaut associé. Les propriétés de l’objet Record identifient le type de nœud.

L’objet Record représente également une autre façon de naviguer dans les données organisées hiérarchiquement. Un objet Record peut être créé pour représenter la racine d’une sous-arborescence spécifique dans une grande structure d’arborescence et les nouveaux objets Record peuvent être ouverts pour représenter les nœuds enfants.

Une ressource (par exemple, un fichier ou un répertoire) peut être identifiée de manière unique par une URL absolue. Un objet Connection est implicitement créé et défini sur l’objet Record lorsque l’enregistrement est ouvert à l’aide d’une URL absolue. Un objet Connection peut être explicitement défini sur l’objet Record via la propriété ActiveConnection . Les fichiers et répertoires accessibles à l’aide de l’objet Connection définissent le contexte dans lequel les opérations d’enregistrement peuvent se produire.

Les méthodes de modification et de navigation des données sur l’objet Record acceptent également une URL relative, qui localise une ressource à l’aide d’une URL absolue ou du contexte de l’objet Connection comme point de départ.

Remarque

Les URL utilisant le schéma http appellent automatiquement le fournisseur Microsoft OLE DB pour la publication Internet. Pour plus d’informations, consultez URL absolues et relatives.

Un objet Connection est associé à chaque objet Record . Par conséquent, les opérations d’objet Record peuvent faire partie d’une transaction en appelant des méthodes de transaction d’objet Connection .

L’objet Record ne prend pas en charge les événements ADO et ne répond donc pas aux notifications.

Avec les méthodes et les propriétés d’un objet Record , vous pouvez effectuer les opérations suivantes :

• Définissez ou retournez l’objet Connection associé à la propriété ActiveConnection .

• Indiquez les autorisations d’accès avec la propriété Mode .

• Retourne l’URL du répertoire, le cas échéant, qui contient la ressource représentée par l’enregistrement avec la propriété ParentURL .

• Indiquez l’URL absolue, l’URL relative ou l’objet Recordset à partir duquel l’enregistrement est dérivé avec la propriété Source .

• Indiquez l’état actuel de l’enregistrement avec la propriété State .

• Indiquez le type d’enregistrement - simple, de collection ou de document structuré avec la propriété RecordType .

• Arrêtez l’exécution d’une opération asynchrone avec la méthode Cancel .

• Dissociez l’enregistrement d’une source de données avec la méthode Close .

• Copiez le fichier ou le répertoire représenté par un enregistrement à un autre emplacement avec la méthode CopyRecord .

• Supprimez le fichier, ou le répertoire et les sous-répertoires, représentés par un enregistrement avec la méthode DeleteRecord .

• Ouvrez un recordset qui contient des lignes qui représentent les sous-répertoires et les fichiers de l’entité représentée par l’enregistrement avec la méthode GetChildren .

• Déplacez (renommez) le fichier, ou le répertoire et les sous-répertoires, représentés par un enregistrement vers un autre emplacement avec la méthode MoveRecord .

• Associez l’enregistrement à une source de données existante ou créez un fichier ou un répertoire à la méthode Open .

L’objet Record est sécurisé pour l’écriture de scripts.

Cette section contient la rubrique suivante.

• Enregistrer les propriétés, méthodes et événements de l’objet

Voir aussi

Fields, collection (ADO)
Collection de Propriétés (ADO)
enregistrements et flux
objet Recordset (ADO)