ADO > le modèle ActiveX Data Object

Il s'agit ici de donner un déscriptif de l'ADO. Vous trouverez :
> les objets : Command, Connection, Error, Field, Parameter, Property, et Recordset
> les collection Errors, Fields et Properties

L'objet Command

Méthodes
Nom	Retour	Description
Cancel		Annule l'exécution de l'appel de méthode Execute ou Open qui est en cours.
CreateParameter	Objet Parameter	Crée un nouvel objet Parameter.
Execute	Objet Recordset	Exécute la requête, l'instruction SQL ou la procédure stockée spécifiée dans la propriété CommandText.

Propriétés
Nom	Type	Description
ActiveConnection	Objet Connection	Indique à quel objet Connection l'objet Command spécifié appartient.
CommandText	Chaîne	Contient le texte de la commande que vous souhaitez exécuter sur la source de données
CommandTimeout	Long	Indique en secondes le temps d’attente au-delà duquel l’exécution de la commande se termine et une erreur est générée. La valeur par défaut est de 30.
CommandType	Constante CommandTypeEnum	Indique quel est le type de l’objet Command.
Name	Chaîne	Indique le nom de l’objet Command.
Parameters	Objet Parameters	Collection d’objets Parameter pour l'objet Command.
Prepared	Booléen	Indique s’il faut enregistrer une version compilée de la commande avant son exécution.
Properties	Collections Properties	Collection d’objets Property.
State	Long	Indique si l'objet Command est ouvert ou fermé. Lecture seule.

L'objet Connection

Méthodes
Nom	Retour	Description
BeginTrans	Entier	Démarre une nouvelle transaction.
Cancel		Annule l'exécution pour un appel asynchrone de la méthode Execute ou Open.
Close		Ferme une Connection ouverte et tous les objets dépendants.
CommitTrans		Enregistre les modifications et met fin à la transaction courante.
Execute	Objet Recordset	Exécute la requête spécifiée, l'instruction SQL ou la procédure stockée.
Open		Ouvre la connexion vers la source de données pour pouvoir y exécuter des commandes.
OpenSchema	Objet Recordset	Permet d’obtenir des informations concernant le schéma de base de données auprès de la source.
RollbackTrans		Annule les modifications effectuées au cours de la transaction courante et met fin à la transaction.

Propriétés
Nom	Type	Description
Attributes	Long	Indique le nombre de caractéristiques d'un objet Connection. La valeur par défaut est 0.
CommandTimeout	Long	Indique en secondes le délai d'exécution de la commande. Passé ce délai il faut mettre fin à la tentative et générer une erreur. La valeur par défaut est 30.
ConnectionString	Chaîne	Contient les informations utilisées pour établir une connexion avec la source de données.
ConnectionTimeout	Long	Indique en seconde le temps d’attente pour l’établissement de la connexion, au-delà duquel il faut mettre fin à la tentative et générer une erreur. La valeur par défaut est 15.
CursorLocation	Constante CursorLocationEnum	Définit ou retourne l’emplacement du curseur.
DefaultDatabase	Chaîne	Indique la base de données par défaut pour l’objet Connection.
Errors	Collection Errors	Cette collection contient tous les objets Error créés en réponse à une défaillance du fournisseur.
IsolationLevel	Constante IsolationLevelEnum	Indique le niveau d’isolation de transaction de l’objet Connection. Propriété en Ecriture seule.
Mode	Constante ConnectModeEnum	Indique les permissions disponibles pour la modification des données dans l’objet Connection.
Properties	Collection Properties	Collection d’objets Property.
Provider	String	Indique le nom du fournisseur pour l’objet Connection.
State	Long	Fournit l’état courant de l’objet Connection. Lecture seule.
Version	Chaîne	Indique le numéro de version ADO. Lecture seule.

Evénements

Nom	Description
BeginTransComplete	Se déclenche à la fin de l'exécution de la méthode BeginTrans.
CommitTransComplete	Se déclenche à la fin de l'exécution de la méthode CommitTrans.
ConnectComplete	Se déclenche lorsque la connexion a commencé.
Disconnect	Se déclenche lorsque la connexion prend fin.
ExecuteComplete	Se déclenche à la fin de l'exécution d'une commande.
InfoMessage	Se déclenche dès qu'une opération ConnectionEvent££ se termine avec succès et que le fournisseur retourne des informations complémentaires.
RollbackTransComplete	Se déclenche lorsqu'une opération RollbackTrans se termine.
WillConnect	Se déclenche avant que la connexion ne débute.
WillExecute	Se déclenche avant que la commande en cours ne s'exécute sur la connexion.

L'objet Error

Propriétés
Nom	Type	Description
Description	Chaîne	Chaîne descriptive associée à l’objet Error. Lecture seule.
HelpContext	Entier	Indique l'ID de contexte (ContextID) pour le fichier d’aide associé à l’objet Error. Lecture seule.
HelpFile	Chaîne	Indique le fichier d’aide et le sujet associé à l’objet Error. Lecture seule.
NativeError	Long	Indique le fichier d’aide et le sujet associé à l’objet Error. Lecture seule.
Number	Long	Indique le numéro unique qui identifie l'objet Error. Lecture seule.
Source	Chaîne	Indique le nom de l’objet ou de l’application qui a généré l’erreur en premier. Lecture seule.
SQLState	Chaîne	Indique l'état SQL associé à l’objet Error. Il s'agit d'une chaîne de cinq caractères conforme au standard SQL ANSI. Lecture seule.

L'objet Field

Méthodes
Nom	Retour	Description
AppendChunk		Place les données à la suite dans un objet Field contenant de grandes quantités de données texte or binaire.
GetChunk	Variant	Retourne tout ou partie du contenu d’un objet Field contenant de grandes quantités de données texte or binaire.

Propriétés
Nom	Type	Description
ActualSize	Long	Indique la longueur réelle de la valeur d’un champ. Lecture seule.
Attributes	Long	Indique une ou plusieurs caractéristiques de l’objet Field.
DataFormat	Variant	Ecriture seule.
DefinedSize	Long	Indique la taille définie pour l’objet Field. Ecriture seule.
Name	Chaîne	Indique le nom de l’objet Field.
NumericScale	Octet	Indique l’échelle des valeurs numériques dans l'objet Field. Ecriture seule.
OriginalValue	Variant	Indique la valeur originale contenue dans l’objet Field avant les modifications. Lecture seule.
Precision	Octet	Degré de précision des valeurs numériques dans l'objet Field. Lecture seule.
Properties	Collection Properties	Collection d’objets Property.
Type	Constante DataTypeEnum	Indique le type d’opérations ou le type de données d’un objet Field.
UnderlyingValue	Variant	Indique la valeur courante de l’objet Field dans la base de données. Lecture seule.
Value	Variant	Indique la valeur affectée à l’objet Field.

L'objet Parameter

Méthodes
Nom	Retour	Description
AppendChunk		Ajoute des données à la suite dans un objet Parameter contenant de grandes quantités de données binaires ou texte.

Propriétés
Nom	Type	Description
Attributes	Long	Indique une ou plusieurs caractéristiques de l’objet Parameter.
Direction	Constante ParameterDirectionEnum	Indique si l’objet Parameter correspond à une entrée (input), une sortie (output) ou aux deux, ou à une valeur de retour provenant d’une procédure stockée.
Name	Chaîne	Indique le nom de l’objet Parameter.
NumericScale	Octet	Indique l’échelle des valeurs numériques dans l'objet Parameter.
Precision	Octet	Degré de précision des valeurs numériques dans l'objet Parameter.
Properties	Collection Properties	Collection des objets Property pour ce paramètre.
Size	Long	Indique en octets la taille maximum de l’objet Parameter.
Type	Constante DataTypeEnum	Indique le type des données que contient l'objet Parameter.
Value	Variant	Indique la valeur affectée à l'objet Parameter.

L'objet Property

Propriétés
Nom	Retour	Description
Attributes	Long	Indique une ou plusieurs caractéristiques de l’objet Property.
Name	Chaîne	Indique le nom de l’objet Property. Lecture seule.
Type	Constante DataTypeEnum	Indique le type de données de l’ objet Property.
Value	Variant	Indique la valeur affectée à l’objet Property.

L'objet Recordset

Méthodes
Nom	Retour	Description
AddNew		Crée un nouvel enregistrement dans un Recordset pouvant être mis à jour.
Cancel		Annule l'exécution de l'appel de méthode asynchrone Open en cours.
CancelBatch		Annule une mise à jour par lot en cours.
CancelUpdate		Annule toutes les modifications apportées à l’enregistrement courant ou au nouvel enregistrement avant l'appel de méthode Update.
Clone	Objet Recordset	Crée un objet Recordset en duplicata à partir d’un objet Recordset existant.
Close		Ferme un objet Recordset ouvert et tous les objets dépendants.
CompareBookmarks	Constante CompareEnum	Compare deux bookmarks££ et retourne le résultat de cette comparaison.
Delete		Efface l’enregistrement ou le groupe d’enregistrements courant.
Find		Permet de trouver un enregistrement dans un objet Recordset à partir des critères spécifiés.
GetRows	Variant	Récupère dans un tableau plusieurs enregistrements de l’objet Recordset.
GetString	Chaîne	Retourne le jeu d'enregistrement sous forme de chaîne.
Move		Permet de changer l’enregistrement courant dans l’objet Recordset.
MoveFirst		Permet de se positionner sur le premier enregistrement de l’objet Recordset spécifié (le premier enregistrement devient l’enregistrement courant).
MoveLast		Permet de se positionner sur le dernier enregistrement de l’objet Recordset spécifié (le dernier enregistrement devient l’enregistrement courant).
MoveNext		Permet de se positionner sur l’enregistrement suivant dans l’objet Recordset spécifié (cet enregistrement devient l’enregistrement courant).
MovePrevious		Permet de se positionner sur l’enregistrement précédent dans l’objet Recordset spécifié (cet enregistrement devient l’enregistrement courant).
NextRecordset	Objet Recordset	Efface l’objet Recordset courant et retourne l’objet Recordset suivant en avançant par l’intermédiaire d’une série de commandes.
Open		Permet d’ouvrir un objet Recordset
Requery		Met à jour les données dans un objet Recordset en ré-exécutant la requête sur laquelle repose l’objet.
Resync		Rafraîchit les données dans l’objet Recordset courant à partir de la base de données .
Save		Enregistre le jeu d'enregistrement dans un fichier.
Supports	Booléen	Détermine si l’objet Recordset spécifié prend en charge une fonctionnalité particulière.
Update		Enregistre les changements effectués dans l’enregistrement courant de l’objet Recordset.
UpdateBatch		Ecrit sur le disque toutes les mises à jour par lot en cours.

Propriétés
Nom	Type	Description
AbsolutePage	Constante PositionEnum	Spécifie sur quelle page réside l’enregistrement courant.
AbsolutePosition	Constante PositionEnum	Indique la position de l’enregistrement courant dans l’objet Recordset.
ActiveConnection	Variant	Indique quel est l’objet Connection auquel appartient actuellement l’objet Recordset spécifié.
BOF	Booléen	Indique si l’enregistrement courant est placé avant le premier enregistrement de l’objet Recordset.
Bookmark	Variant	Retourne un marque-page identifiant l’enregistrement courant dans l’objet Recordset ou définit un marque-page valide identifiant l’enregistrement courant.
CacheSize	Long	Indique le nombre d’enregistrements qui peuvent être mis en cache localement en mémoire à partir d’un objet Recordset.
Collect	Variant	Collection par défaut d’éléments de champs.
CursorLocation	Constante CursorLocationEnum	Permet de définir ou de retourner l’emplacement du curseur.
CursorType	Constante CursorTypeEnum	Indique le type de curseur utilisé dans l’objet Recordset.
DataMember	Chaîne	Indique le nom du membre de données à récupérer à partir de l'objet référencé par la propriété DataSource. Ecriture seule.
DataSource	Objet MonObjet	Indique l'objet qui contient les données destinées à être représentées par l'objet Recordset. Propriété en Ecriture seule.
EditMode	Constante EditModeEnum	Indique l’état d’édition de l’enregistrement courant.
EOF	Booléen	Indique si l’enregistrement courant se trouve après le dernier enregistrement de l’objet Recordset.
Fields	Collection Fields	Collection d’objet Fields
Filter	Variant	Indique un filtre pour les données de l’objet Recordset.
LockType	Constante LockTypeEnum	Indique le type de lock (réservation) placé sur les enregistrements pendant l’édition.
MarshalOptions	Constante MarshalOptionsEnum	Indique quels sont les enregistrements qui doivent être renvoyés en retour vers le serveur.
MaxRecords	Long	Indique le nombre maximum d’enregistrements à retourner à un objet Recordset à partir d’une requête.
PageCount	Long	Indique le nombre de pages de données que contient l’objet Recordset.
PageSize	Long	Indique le nombre d’enregistrements constituant une page dans l’objet Recordset.
Properties	Collection Properties	Collection d’objets Property.
RecordCount	Long	Indique quel est le nombre actuel d’enregistrement dans l’objet Recordset.
Sort	Chaîne	Indique les champs et l’ordre de tri pour accéder à l’objet Recordset
Source	Variant	Indique la source de données de l’objet Recordset (objet Command, ordre SQL, nom de table, ou procédure stockée).
State	Long	Décrit l’état courant de l’objet Recordset. Lecture seule.
Status	Entier	Indique le statut de l’enregistrement en ce qui concerne les mises à jour par lot ou les autres opérations groupées. Lecture seule.
StayIntSync	Booléen	Pour un objet Recordset hiérarchique, indique s'il faut changer la ligne parente lorsque l'on modifie les enregistrements et les enfants sous-jacents. Propriété en Lecture seule.

Evénements

Nom	Description
EndOfRecordset	Se déclenche si l'on tente de placer un enregistrement après la fin de l'objet Recordset.
FetchComplete	Pour une opération asynchrone, se déclenche lorsque tous les enregistrements on été récupérés dans l'objet Recordset.
FetchProgress	Se déclenche a intervalles réguliers au cours d'une opération asynchrone de longue durée. Cet événement rend compte du nombre d'enregistrements déjà récupérés.
FieldChangeComplete	Se déclenche lorsque la valeur d'un ou de plusieurs objets Field a changé.
MoveComplete	Se déclenche lorsque la position du curseur change dans l'objet Recordset.
RecordChangeComplete	Se déclenche lorsque un ou plusieurs enregistrements ont changé.
RecordsetChangeComplete	Se déclenche lorsque l'objet Recordset a changé.
WillChangeField	Se déclenche avant que l'opération en cours ne modifie la valeur d'un ou de plusieurs objets Field.
WillChangeRecord	Se déclenche avant que un ou plusieurs enregistrements ne soient modifiés dans l'objet Recordset.
WillChangeRecordset	Se déclenche avant que l'opération en cours ne change l'objet Recordset.
WillMove	Se déclenche avant que l'opération en cours ne change la position du curseur dans l'objet Recordset.

La collection Errors

Méthodes
Nom	Retour	Description
Clear		Supprime tous les objets Error dans la collection Errors.
Refresh		Met à jour les objet Error à partir d'informations provenant du fournisseur.

Propriétés
Nom	Type	Description
Count	Long	Indique le nombre d’objets Error dans la collection. Lecture seule.
Item	Objet Error	Cette propriété permet d'indexer la collection Errors pour pouvoir référencer des objets Error spécifiques. Lecture seule.

La collection Fields

Méthodes
Nom	Retour	Description
Append		Ajoute à la suite un nouvel objet Field dans la collection Fields.
Delete		Supprime un objet Field dans la collection.
Refresh		Met à jour les objets Field qui sont dans de la collection.

Propriétés
Nom	Type	Description
Count	Long	Retourne le nombre d’objets contenus dans la collection. Lecture seule.
Item	Objet Field	Retourne le membre de la collection Fields spécifié par son nom pour par son numéro. Lecture seule.

La collection Parameters

Méthodes
Nom	Retour	Description
Append		Ajoute un objet à la collection Parameters.
Delete		Enlève un objet à la collection Parameters.
Refresh		Met à jour les objets Parameter qui se trouvent dans la collection.

Propriétés
Nom	Retour	Description
Count	Entier	Retourne le nombre d’objet que contient la collection. Lecture seule.
Item	Objet Parameter	Retourne le membre de la collection Parameters spécifié par son nom ou par son numéro. Lecture seule.

La collection Properties

Méthodes
Nom	Retour	Description
Refresh		Met à jour les objets Property qui se trouvent dans la collection à partir des informations provenant du fournisseur.

Propriétés
Nom	Type	Description
Count	Entier	Retourne le nombre d’objets dans la collection.
Item	Objet Property	Retourne le membre de la collection Properties spécifié par un nom ou par un numéro.

[ RETOUR ]