Record, objet (ADO)

  • Article

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

Notes

Un objet Record représente une ligne de données, et présente des similitudes conceptuelles avec un objet Recordset d’une ligne. Selon les capacités de votre fournisseur, des objets Record peuvent être retournés directement à partir de votre fournisseur au lieu d’un objet Recordset d’une ligne, par exemple, lors de l’exécution d’une requête SQL qui ne sélectionne qu’une seule ligne. Ou bien un objet Record peut être obtenu directement à partir d’un objet Recordset. Ou encore, un objet Record peut être retourné directement à partir d’un fournisseur de données semi-structurées, tel que le fournisseur OLE DB de 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 d’objet, dont des valeurs Recordset, SafeArray et scalaires dans la collection Fields d’objets Record.

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

L’objet Record peut également être utilisé par des fournisseurs de données semi-structurées tels que le Fournisseur Microsoft OLE DB pour la publication Internet pour modéliser des espaces de noms structurés en arborescence. Chaque nœud dans 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 tant un nœud terminal qu’un nœud non terminal dans l’arborescence. Les nœuds non terminaux contiennent d’autres nœuds, contrairement aux nœuds terminaux. Les nœuds terminaux contiennent généralement des flux binaires de données, et les nœuds non terminaux peuvent également contenir un flux binaire par défaut associé. Des propriétés sur l’objet Record identifient le type de nœud.

L’objet Record représente également une autre façon de naviguer dans des données organisées de façon hiérarchique. Un objet Record peut être créé pour représenter la racine d’une sous-arborescence spécifique dans une grande arborescence, et de nouveaux objets Record peuvent être ouverts pour représenter des 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 quand 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 des opérations Record peuvent se produire.

Les méthodes de modification de données et de navigation dans les données sur l’objet Record acceptent également une URL relative qui localise une ressource en utilisant une URL absolue ou le 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, des 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 prenant pas en charge les événements ADO, il ne répond donc pas aux notifications.

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

  • Définir ou retourner l’objet Connection associé avec la propriété ActiveConnection.

  • Indiquer des autorisations d’accès avec la propriété Mode.

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

  • Indiquer l’URL absolue, l’URL relative ou l’objet Recordset dont l’objet Record est dérivé avec la propriété Source.

  • Indiquer l’état actuel de l’objet Record avec la propriété State.

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

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

  • Dissocier l’objet Record d’une source de données avec la méthode Close.

  • Copier le fichier ou le répertoire représentés par un objet Record vers un autre emplacement avec la méthode CopyRecord.

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

  • Ouvrir un objet Recordset contenant des lignes représentant les sous-répertoires et fichiers de l’entité représentés par l’objet Record avec la méthode GetChildren.

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

  • Associer l’objet Record à une source de données existante, ou créer un fichier ou un répertoire avec la méthode Open.

L’objet Record est sécurisé pour les scripts.

Cette section contient la rubrique suivante.

Voir aussi

Fields, collection (ADO)
Properties, collection (ADO)
Enregistrements et flux
Recordset, objet (ADO)