La propriété ActiveConnection indique à quel objet Connection appartient l'objet Record actuel.

String ou Variant (contenant l'objet Connection en cours)

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.

Méthode Record.Open

La méthode Cancel annule une opération asynchrone de l'objet Record.

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.

Méthode Record.CopyRecord, Méthode Record.DeleteRecord, Méthode Record.MoveRecord, Méthode Record.Open

La méthode Close ferme un objet Record ouvert.

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.

CancelBatch est une méthode membre de l'objet Recordset qui annule la mise à jour par lots en attente.

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.

Chaîne

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.

Énumération CopyRecordOptionsEnum

La méthode DeleteRecord supprime la ressource représentée par l'objet Record actuel, ou un autre objet s'il est spécifié.

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.

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.

Méthode Recordset.Open, Méthode Recordset.Requery, Méthode Recordset.Resync

La collection Fields contient des objets Field séparés pour l'objet Record actuel.

Fields (objet Collection)

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.

Méthode Field.Append, Méthode Field.Update, Énumération FieldEnum

La méthode GetChildren renvoie les enfants d'un objet Record de collection sous la forme d'un objet Recordset.

Objet Recordset

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é.

La propriété Mode indique les autorisations de modification de données dans un objet Record.

ConnectModeEnum

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.

Énumération ConnectModeEnum

La méthode MoveRecord déplace une ressource vers un autre emplacement.

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.

Chaîne

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.

Énumération MoveRecordOptionsEnum, Méthode Record.Close, Méthode Record.Open, Méthode Recordset.Open, Méthode Recordset.Requery, Méthode Recordset.Resync

La méthode Open ouvre un enregistrement dans un jeu d'enregistrements ou une ressource dans une source de données.

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.

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.

Énumération ConnectModeEnum, Énumération RecordCreateOptionsEnum, Énumération RecordOpenOptionsEnum

La propriété ParentURL sert à indiquer l'enregistrement parent de l'objet Record actuel à l'aide d'une URL absolue.

Chaîne

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.

La collection Properties contient des caractéristiques spécifiques à l'objet Record destinées au fournisseur de données en cours.

Properties (objet Collection)

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.

La propriété RecordType indique le type de l'enregistrement actuel.

RecordTypeEnum

La propriété RecordType est en lecture seule ; elle indique le type de l'objet Record actuel.

Énumération RecordTypeEnum

La propriété Source indique à partir de quel objet l'objet Record est créé.

Variant

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.

Propriété Record.ActiveConnection, Méthode Record.Open

La propriété State indique l'état de l'objet Record.

Long (ObjectStateEnum)

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).

Énumération ObjectStateEnum