Objet Record | (Versions 2.5 et 2.6)
Dim record As ADODB.Record L'objet Record représente une ligne dans un objet Recordset ou une ressource dans une source de données semi-structurée, comme un répertoire de fichiers.

Propriété Record.ActiveConnection | (Versions 2.5 et 2.6)
Record.ActiveConnection = ConnectionString Set Record.ActiveConnection = ConnectionObject
La propriété ActiveConnection indique à quel objet Connection appartient l'objet Record actuel.
Type de données
String ou Variant (contenant l'objet Connection en cours)
Description
La propriété ActiveConnection de l'objet Record est en lecture/écriture lorsque l'objet Record est fermé et en lecture seule lorsqu'il est ouvert. Cette propriété peut être fixée à une chaîne de connexion ou un objet Connection, et elle renvoie un objet Connection lorsqu'elle est lue. Si l'objet Record a été ouvert à partir d'un objet Record ou d'un objet Recordset existant, c'est à partir de celui-ci que l'objet Record obtient son objet Connection. Si l'objet Record a été ouvert à l'aide d'une URL, un objet Connection est créé automatiquement pour celui-ci et est accessible à partir de la propriété ActiveConnection.
Voir aussi
Méthode Record.Open

Méthode Record.Cancel | (Versions 2.5 et 2.6)
record.Cancel
La méthode Cancel annule une opération asynchrone de l'objet Record.
Description
La méthode Cancel peut être appelée pour annuler une opération asynchrone de l'objet Record invoqué par les méthodes CopyRecord, DeleteRecord, MoveRecord et Open.
Voir aussi
Méthode Record.CopyRecord, Méthode Record.DeleteRecord, Méthode Record.MoveRecord, Méthode Record.Open

Méthode Record.Close | (Versions 2.5 et 2.6)
record.Close
La méthode Close ferme un objet Record ouvert.
Description
La méthode Close ne peut être appelée que sur un objet Record ouvert. Après l'appel de la méthode Close, la méthode Open peut être de nouveau appelée afin de rouvrir l'objet Record. L'appel de la méthode Close libère toutes les ressources attribuées à l'objet Record.

Méthode Record.CopyRecord | (Versions 2.5 et 2.6)
record.CopyRecord (Source, _ Destination, _ UserName, _ Password, _ Options, _ Async) As String
CancelBatch est une méthode membre de l'objet Recordset qui annule la mise à jour par lots en attente.
Arguments
Source (Chaîne) Facultatif. Indique l'URL de la ressource à copier. Si cet argument est omis, la ressource représentée par l'objet Record actuel est copiée. Destination (Chaîne) Facultatif. Représente une valeur URL qui indique où la ressource sera copiée. UserName (Chaîne) Facultatif. Indique, si nécessaire, le nom d'utilisateur qui sera utilisé pour accéder à la ressource indiquée par l'argument Destination. Password (Chaîne) Facultatif. Indique, si nécessaire, le mot de passe utilisé pour vérifier l'argument UserName. Options (CopyRecordOptionsEnum) Facultatif. Indique le comportement de l'opération de copie. La valeur par défaut de cet argument est adCopyUnspecified. Async (Booléen) Facultatif. Indique si l'opération doit être exécutée de manière asynchrone.
Valeurs renvoyées
Chaîne
Description
Par défaut, la méthode CopyRecord ne remplace pas les ressources existantes. Pour forcer le remplacement de la ressource de destination, utilisez l'option adCopyOverWrite. Par défaut, la méthode CopyRecord copie tous les sous-répertoires et les fichiers sous la ressource source, sauf si l'option adCopyNonRecursive est spécifiée. Si les ressources source et de destination sont identiques, une erreur se produit. Si la ressource de destination est un enfant de la ressource source, l'opération ne se terminera jamais. Même si la valeur retournée dépend du fournisseur, il s'agit généralement du nom de la ressource de destination.
Voir aussi
Énumération CopyRecordOptionsEnum

Méthode Record.DeleteRecord | (Versions 2.5 et 2.6)
record.DeleteRecord Source, Async
La méthode DeleteRecord supprime la ressource représentée par l'objet Record actuel, ou un autre objet s'il est spécifié.
Arguments
Source (Chaîne) Facultatif. Définit la ressource à supprimer. Si cet argument est omis, la ressource représentée par l'objet Record actuel est supprimée. Async (Booléen) Facultatif. Indique si l'opération doit être exécutée de manière asynchrone.
Description
La méthode DeleteRecord supprime également toutes les ressources enfants de la ressource actuelle. L'objet Record doit être fermé immédiatement après l'appel de la méthode DeleteRecord, car son comportement est imprévisible. Dans le meilleur cas, une erreur se produira si vous tentez de manipuler un objet Record qui représente une ressource supprimée. Si l'objet Record a été créé à partir d'un objet Recordset, fermez ce dernier puis rouvrez-le, ou appelez Resync ou Requery de manière à en supprimer la ressource.
Voir aussi
Méthode Recordset.Open, Méthode Recordset.Requery, Méthode Recordset.Resync

Collection Record.Fields | (Versions 2.5 et 2.6)
record.Fields
La collection Fields contient des objets Field séparés pour l'objet Record actuel.
Type de données
Fields (objet Collection)
Description
La collection Fields contient de multiples objets Field pour l'objet Record actuel. Il existe deux objets Field spéciaux, adDefaultStream et adRecordURL, qui sont accessibles si vous spécifiez l'énumération FieldEnum. L'un renvoie la chaîne par défaut pour l'objet Record actuel et l'autre renvoie l'URL. Les objets Field peuvent être ajoutés à la collection soit en appelant la méthode Field.Append, soit en faisant référence, via un nom, à un objet Field ne faisant pas déjà partie de la collection. Appeler la méthode Field.Update ajoute le champ à la collection, si possible, dans la source de données. En attendant, la propriété Field.Status renvoie adFieldPendingInsert.
Voir aussi
Méthode Field.Append, Méthode Field.Update, Énumération FieldEnum

Méthode Record.GetChildren | (Versions 2.5 et 2.6)
Set recordset = record.GetChildren
La méthode GetChildren renvoie les enfants d'un objet Record de collection sous la forme d'un objet Recordset.
Valeurs renvoyées
Objet Recordset
Description
La méthode GetChildren renvoie un objet Recordset contenant les enfants de l'objet Record actuel. Chaque enregistrement dans l'objet Recordset retourné représente une ressource enfant de la ressource représentée par l'objet Record associé.

Propriété Record.Mode | (Versions 2.5 et 2.6)
record.Mode = ConnectModeEnum
La propriété Mode indique les autorisations de modification de données dans un objet Record.
Type de données
ConnectModeEnum
Description
La valeur par défaut de la propriété Mode d'un objet Record est adModeRead. La propriété Mode est en lecture/écriture lorsque l'objet Record est fermé et en lecture seule lorsqu'il est ouvert.
Voir aussi
Énumération ConnectModeEnum

Méthode Record.MoveRecord | (Versions 2.5 et 2.6)
record.MoveRecord (Source, _ Destination, _ UserName, _ Password, _ Options, _ Async) As String
La méthode MoveRecord déplace une ressource vers un autre emplacement.
Arguments
Source (Chaîne) Facultatif. Indique l'URL de la ressource à déplacer. Si cet argument est omis, la ressource représentée par l'objet Record actuel est déplacée. Destination (Chaîne) Facultatif. Représente une valeur URL qui indique où la ressource sera déplacée. UserName (Chaîne) Facultatif. Indique, si nécessaire, le nom d'utilisateur qui sera utilisé pour accéder à la ressource indiquée par l'argument Destination. Password (Chaîne) Facultatif. Indique, si nécessaire, le mot de passe utilisé pour vérifier l'argument UserName. Options (CopyRecordOptionsEnum) Facultatif. Indique le comportement de l'opération de déplacement. La valeur par défaut de cet argument est adMoveUnspecified. Async (Booléen) Facultatif. Indique si l'opération doit être exécutée de manière asynchrone.
Valeurs renvoyées
Chaîne
Description
Par défaut, la méthode MoveRecord ne remplace pas les ressources existantes. Pour forcer le remplacement de la ressource de destination, utilisez l'option adCopyOverWrite. Tous les liens hypertexte du fichier sont automatiquement mis à jour, sauf si le contraire est précisé dans l'argument Options. Si les ressources source et de destination sont identiques, une erreur se produit. Si l'objet Record a été créé à partir d'un objet Recordset, fermez ce dernier puis rouvrez-le, ou appelez Resync ou Requery de manière à supprimer la ressource du jeu d'enregistrements. Toutes les propriétés de l'objet Record ne sont pas repeuplées automatiquement ; pour ce faire, fermez l'objet Record puis rouvrez-le. Même si la valeur retournée dépend du fournisseur, il s'agit généralement du nom de la ressource de destination.
Voir aussi
Énumération MoveRecordOptionsEnum, Méthode Record.Close, Méthode Record.Open, Méthode Recordset.Open, Méthode Recordset.Requery, Méthode Recordset.Resync

Méthode Record.Open | (Versions 2.5 et 2.6)
record.Open (Source, _ ActiveConnection, _ Mode, _ CreateOptions, _ Options, _ UserName, _ Password)
La méthode Open ouvre un enregistrement dans un jeu d'enregistrements ou une ressource dans une source de données.
Arguments
Source (Variant) Facultatif. Indique la source de la ressource à ouvrir. Il peut s'agir d'une URL, d'un objet Command qui renvoie une ligne unique, d'un objet Recordset ouvert ou d'un objet String contenant une instruction SQL ou un nom de table. ActiveConnection (Variant) Facultatif. Indique la connexion à la source de données, au moyen d'une chaîne de connexion ou d'un objet Connection ouvert. Mode (ConnectModeEnum) Facultatif. Indique les autorisations d'accès requises pour l'ouverture de l'objet Record. La valeur par défaut est adModeUnknown. CreateOptions (CreateModeEnum) Facultatif. Cet argument n'est utilisé que si l'argument Source représente une URL. Cet argument peut servir à indiquer s'il faut ouvrir une ressource existante ou en créer une nouvelle. La valeur par défaut de cet argument est adFailIfNotExist. Options (RecordOpenOptionsEnum) Facultatif. Peut contenir plusieurs valeurs d'énumération RecordOpenOptionsEnum qui indiquent des options spéciales pour l'ouverture de l'objet Record. La valeur par défaut de cette méthode est adOpenRecordUnspecified. UserName (Chaîne) Facultatif. Indique, si nécessaire, le nom d'utilisateur qui sera utilisé pour accéder à la ressource indiquée par l'argument source. Password (Chaîne) Facultatif. Indique, si nécessaire, le mot de passe utilisé pour vérifier l'argument UserName.
Description
Si l'objet Record représente une ressource qui ne peut pas être représentée par une URL, la propriété ParentURL et le champ par défaut adRecordURL renvoient tous deux Null.
Voir aussi
Énumération ConnectModeEnum, Énumération RecordCreateOptionsEnum, Énumération RecordOpenOptionsEnum

Propriété Record.ParentURL | (Versions 2.5 et 2.6)
record.ParentURL = ParentURL
La propriété ParentURL sert à indiquer l'enregistrement parent de l'objet Record actuel à l'aide d'une URL absolue.
Type de données
Chaîne
Description
La propriété ParentURL indique la ressource parente de la ressource actuelle représentée par l'objet Record. La propriété est définie sur lecture seule. La propriété ParentURL peut être Null s'il n'existe pas de parent de la ressource actuelle représentée par l'objet Record ou si la ressource ne peut pas être exprimée sous la forme d'une URL.

Collection Record.Properties | (Versions 2.5 et 2.6)
record.Properties
La collection Properties contient des caractéristiques spécifiques à l'objet Record destinées au fournisseur de données en cours.
Type de données
Properties (objet Collection)
Description
La classe de collection Properties contient une instance de classe Property pour chaque propriété spécifique à l'objet Record pour le fournisseur de données.

Propriété Record.RecordType | (Versions 2.5 et 2.6)
record.RecordType = RecordTypeEnum
La propriété RecordType indique le type de l'enregistrement actuel.
Type de données
RecordTypeEnum
Description
La propriété RecordType est en lecture seule ; elle indique le type de l'objet Record actuel.
Voir aussi
Énumération RecordTypeEnum

Propriété Record.Source | (Versions 2.5 et 2.6)
Set record.Source = object
La propriété Source indique à partir de quel objet l'objet Record est créé.
Type de données
Variant
Description
La propriété Source est en lecture seule lorsque l'objet Record est ouvert et en lecture/écriture lorsqu'il est fermé. La propriété Source peut être définie sur un objet Recordset ou Command. Si la propriété Source est définie sur un objet Recordset, l'objet Record sera ouvert en fonction de l'enregistrement actuel de l'objet Recordset. Si la propriété Source est définie sur un objet Command, ce dernier doit retourner une ligne unique. Si la propriété ActiveConnection est également définie, la propriété Source doit être définie sur un objet qui se trouve dans l'étendue de la connexion. La propriété Source retourne l'argument Source de la méthode Record.Open.
Voir aussi
Propriété Record.ActiveConnection, Méthode Record.Open

Propriété Record.State | (Versions 2.5 et 2.6)
state = record.State
La propriété State indique l'état de l'objet Record.
Type de données
Long (ObjectStateEnum)
Description
La propriété en lecture seule State renvoie une valeur de type Long qui peut être évaluée en tant que valeur d'énumération ObjectStateEnum. La valeur par défaut de l'objet Record est fermée (adStateClosed). Pour l'objet Record, la propriété State peut retourner plusieurs valeurs lorsque l'objet exécute une opération de manière asynchrone (c.-à-d. adStateOpen et adStateExecuting).
Voir aussi
Énumération ObjectStateEnum