Objet Connection

Objet Connection	(Versions 2.0, 2.1, 2.5 et 2.6)

Dim connection As ADODB.Connection Un objet Connection représente une connexion unique à une source de données. Les objets Connection sont indépendants de tous les autres objets ADO.

Propriété Connection.Attributes	(Versions 2.0, 2.1, 2.5 et 2.6)

Connection.Attributes = XactArgumentsEnum [+ XactArgumentsEnum...]

La propriété Attributes permet de définir ou de renvoyer des caractéristiques spécifiques au sujet de l'objet Connection.
Type de données
XactArgumentsEnum (Long)

Description
La propriété Attributes est définie sur lecture/écriture. La valeur de la propriété Attributes peut être définie sur toute somme des valeurs de l'énumération ParameterArgumentsEnum figurant dans l'annexe E. La valeur par défaut de la propriété Attributes est zéro.

Remarque
Les fournisseurs de données ne prennent pas tous en charge la propriété Attributes.

Voir aussi
Méthode Connection.BeginTrans, Méthode Connection.CommitTrans, Méthode Connection.RollBackTrans, Enumération XactAttributeEnum

Méthode Connection.BeginTrans	Méthode CBT (Versions 2.0, 2.1, 2.5 et 2.6)

connection.BeginTrans level = connection.BeginTrans( ) connection.CommitTrans connection.RollbackTrans

Les méthodes BeginTrans, CommitTrans et RollbackTrans sont utilisées pour gérer le traitement de transactions pour l'objet Connection en cours. La méthode BeginTrans commence une transaction. La méthode CommitTrans termine la transaction en cours, après avoir enregistré les modifications éventuelles et commencé entièrement une autre transaction. La méthode RollbackTrans termine la transaction en cours, mais restaure toute modification apportée pendant la transaction actuelle. De plus, la méthode RollbackTrans peut commencer une autre transaction, tout comme la méthode CommitTrans.
Description
Les méthodes BeginTrans, CommitTrans et RollbackTrans de l'objet Connection effectuent la gestion des transactions dans une connexion spécifique. Les systèmes bancaires présentent l'exemple le plus courant de la nécessité de gestion des transactions. Lorsque vous effectuez un transfert de fonds entre comptes, il est essentiel que les deux étapes impliquées (un retrait suivi d'un virement) s'exécutent comme une seule intervention. En utilisant ces trois méthodes de gestion des transactions, vous êtes sûr que les deux étapes bancaires sont exécutées ou qu'aucune de ces deux étapes n'est exécutée (l'une des étapes ne peut pas s'exécuter toute seule). Si un problème de virement survient après le retrait, la restauration peut être appliquée grâce à la méthode RollbackTrans. La méthode BeginTrans commence une nouvelle transaction au sein de l'objet Connection actif. En utilisant la méthode BeginTrans, vous pouvez créer des transactions imbriquées tout comme vous créez des instructions If . . . Then imbriquées dans votre code. Vous pouvez recevoir une valeur sous forme Long de la méthode BeginTrans si le fournisseur de données prend en charge les transactions imbriquées. Cette valeur indique le niveau de la transaction imbriquée qui a été créée : le numéro un représente la première transaction. La méthode CommitTrans applique toutes les modifications apportées depuis le début de la dernière transaction. La méthode RollbackTrans quant à elle effectue l'inverse, elle annule toutes les modifications apportées à la dernière transaction. Dans les deux cas, la dernière transaction est terminée. De plus, la dernière transaction créée doit se terminer avant que les méthodes CommitTrans ou RollbackTrans puissent terminer une transaction précédente. Si la propriété Arguments de l'objet Connection est définie sur adXactCommitRetaining, une nouvelle transaction est automatiquement créée après un appel de la méthode CommitTrans. Si cette propriété est définie sur adXactAbortRetaining, une nouvelle transaction est créée automatiquement après un appel de la méthode RollbackTrans.

Voir aussi
Propriété Connection.Arguments

Evénement Connection.BeginTransComplete	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub BeginTransComplete(ByVal TransactionLevel As Long, _ ByVal pError As ADODB.Error, _ adStatus As ADODB.EventStatusEnum, _ ByVal pConnection As ADODB.Connection)

L'événement BeginTransComplete est déclenché lorsque la méthode BeginTrans a terminé son opération.
Arguments
TransactionLevel Une valeur Long indiquant le niveau d'imbrication de la nouvelle transaction. pError Un objet Error contenant les informations relatives à une erreur qui s'est produite, si le paramètre adStatus est défini sur adStatusErrorsOccurred. adStatus Une valeur EventStatusEnum indiquant l'état de l'opération en cours. Si le paramètre adStatus est défini sur adStatusOK, l'opération a réussi. Si le paramètre adStatus est défini sur adStatusErrorsOccurred, l'opération a échoué et l'objet pError contient les informations relatives à l'erreur. En définissant le paramètre adStatus sur adStatusUnwantedEvent, cet événement n'est pas rappelé. pConnection L'objet Connection qui a déclenché cet événement.

Voir aussi
Méthode Connection.BeginTrans, Evénement Connection.CommitTransComplete, Evénement Connection.RollbackTransComplete, Enumération EventStatusEnum

Méthode Connection.Cancel	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.Cancel

La méthode Cancel annule la connexion asynchrone ou l'exécution en attente.
Description
Si les méthodes Execute ou Open d'un objet Connection ont été appelées avec les options adAsyncConnect, adAsyncExecute ou adAsyncFetch, la méthode Cancel annulera l'opération asynchrone en attente. Si la méthode Cancel est appelée pour une opération qui n'a pas été exécutée avec l'option adAsyncExecute définie, une erreur sera générée.

Voir aussi
Méthode Connection.Execute, Méthode Connection.Open

Méthode Connection.Close	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.Close

La méthode Close est utilisée pour fermer un objet Connection ou Recordset, y compris tout objet dépendant éventuellement présent.
Description
La méthode Close met fin à la connexion à une source de données. Après la fermeture d'un objet Connection, les propriétés peuvent être ajustées, et l'objet rouvert. L'appel aux méthodes qui requièrent une connexion alors que l'objet Connection est fermé, génère une erreur. La fermeture d'un objet Connection, à partir duquel un ou plusieurs objets Recordset ont été créés entraîne également la fermeture de ces objets Recordset. Toutes les modifications en attente sont perdues. Si une transaction est en attente, une erreur survient. La fermeture d'un objet Connection n'entraîne pas sa suppression de la mémoire, mais seulement la libération des ressources qu'il utilise. Pour effacer l'objet Connection de la mémoire dans Visual Basic, celui-ci doit être défini sur Nothing.

Propriété Connection.CommandTimeout	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.CommandTimeout = timeout

La propriété CommandTimeout indique le temps d'attente de l'objet ADO avant de générer une erreur lors de l'exécution d'une commande particulière.
Type de données
Long

Description
La propriété CommandTimeout est définie sur lecture/écriture. En utilisant la propriété CommandTimeout, vous pouvez spécifier le temps que l'objet ADO attendra l'exécution d'une commande. La valeur de la propriété CommandTimeout est exprimée en secondes, et la valeur par défaut est de 30 secondes. Si vous définissez la propriété sur zéro, vous autorisez l'objet ADO à attendre indéfiniment l'exécution d'une commande spécifiée. Si une commande dépasse le délai d'attente, une erreur est générée. La propriété CommandTimeout de l'objet Command est distincte de la propriété CommandTimeout de l'objet Connection. La propriété CommandTimeout de l'objet Connection est définie sur lecture/écriture même lorsque l'objet Connection est ouvert.

Remarque
Les fournisseurs de données ne prennent pas tous en charge la propriété CommandTimeout.

Méthode Connection.CommitTrans	(Versions 2.0, 2.1, 2.5 et 2.6)



s Voir la méthode Connection.BeginTrans.

Evénement Connection.CommitTransComplete	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub CommitTransComplete(ByVal pError As ADODB.Error, _ adStatus As ADODB.EventStatusEnum, _ ByVal pConnection As ADODB.Connection)

L'événement CommitTransComplete est déclenché lorsque la méthode CommitTrans a terminé son opération.
Arguments
pError Un objet Error contenant les informations relatives à une erreur qui s'est produite, si le paramètre adStatus est défini sur adStatusErrorsOccurred. adStatus Une valeur EventStatusEnum indiquant l'état de l'opération en cours. Si le paramètre adStatus est défini sur adStatusOK, l'opération a réussi. Si le paramètre adStatus est défini sur adStatusErrorsOccurred, l'opération a échoué et l'objet pError contient les informations relatives à l'erreur. En définissant le paramètre adStatus sur adStatusUnwantedEvent, cet événement n'est pas rappelé. pConnection L'objet Connection qui a déclenché cet événement.

Voir aussi
Evénement Connection.BeginTransComplete, Méthode Connection.CommitTrans, Evénement Connection.RollbackTransComplete, Enumération EventStatusEnum

Evénement Connection.ConnectComplete	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub ConnectComplete(ByVal pError As ADODB.Error, _ adStatus As ADODB.EventStatusEnum, _ ByVal pConnection As ADODB.Connection)

L'événement ConnectComplete est déclenché une fois que la connexion a été établie.
Arguments
pError Un objet Error contenant les informations relatives à une erreur qui s'est produite, si le paramètre adStatus est défini sur adStatusErrorsOccurred. adStatus Une valeur EventStatusEnum indiquant l'état de l'opération en cours. Si le paramètre adStatus est défini sur adStatusOK, l'opération a réussi. Si le paramètre adStatus est défini sur adStatusErrorsOccurred, l'opération a échoué et l'objet pError contient les informations relatives à l'erreur. Si le paramètre adStatus est défini sur adStatusUnwantedEvent, cet événement n'est pas rappelé. pConnection L'objet Connection qui a déclenché cet événement.

Voir aussi
Evénement Connection.Disconnect, Evénement Connection.WillConnect, Enumération ConnectOptionEnum, Enumération EventStatusEnum

Propriété Connection.ConnectionString	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.ConnectionString = connectionstring

La propriété ConnectionString définit la connexion utilisée pour accéder à une source de données.
Type de données
String

Description
La propriété ConnectionString indique la source de données que votre connexion doit utiliser. Vous pouvez transmettre un DSN (nom de la source de données) ou une chaîne de connexion détaillée, c'est-à-dire une liste d'arguments. Les arguments doivent prendre la forme argument=value, avec dans le cas de plusieurs arguments, un point-virgule de séparation. Si l'objet ADO rencontre un signe égal dans la propriété ConnectionString, il suppose que vous transmettez une chaîne de connexion détaillée.

Arguments
Les trois arguments pris en charge sont répertoriés ici. Si vous transmettez d'autres arguments, ils sont transmis directement au fournisseur de données sans être vérifiés par l'objet ADO. Provider Indique le nom du fournisseur de données à utiliser pour établir une connexion particulière. Filename Indique le nom d'un fichier spécifique au fournisseur de données contenant les informations de connexion. Cet argument ne peut pas être associé à l'argument Provider. URL Identifie l'URL absolue d'un fichier ou répertoire. Le contenu de la propriété ConnectionString peut être modifié par l'objet ADO à tout moment après l'ouverture de l'objet Connection. Il est recommandé de lire la propriété si vous n'êtes pas sûr de son contenu. Si l'argument ConnectionString a été utilisé dans la méthode Open de l'objet Connection, la valeur est placée à l'intérieur de la propriété ConnectionString de l'objet Connection. Pendant que l'objet Connection est ouvert, l'argument ConnectionString est en lecture seule. Toutefois, lorsque l'objet est fermé, l'argument est en lecture/écriture.

Voir aussi
Méthode Connection.Open

Propriété Connection.ConnectionTimeout	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.ConnectionTimeout = timeout

La propriété ConnectionTimeout indique le temps d'attente, en secondes, de l'objet ADO pendant la tentative de connexion à une source de données.
Type de données
Long

Description
En utilisant la propriété ConnectionTimeout, vous pouvez spécifier le temps que l'objet ADO attendra la connexion à une source de données. La valeur de la propriété ConnectionTimeout est représentée en secondes. Si vous définissez la propriété sur zéro, vous autorisez l'objet ADO à attendre indéfiniment une connexion spécifiée. Si une connexion dépasse le délai, une erreur est générée. La propriété ConnectionTimeout est en lecture/écriture lorsque l'objet Connection est fermé et en lecture seule lorsque l'objet est ouvert.

Remarque
Les fournisseurs de données ne prennent pas tous en charge la propriété ConnectionTimeout.

Voir aussi
Méthode Connection.Open

Propriété Connection.CursorLocation	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.CursorLocation = CursorLocationEnum

La propriété CursorLocation indique l'emplacement du service de curseur.
Type de données
CursorLocationEnum (Long)

Description
La valeur de la propriété CursorLocation peut être définie sur l'une des valeurs CursorLocationEnum correctes répertoriées à l'annexe E. La valeur de la propriété CursorLocation est en lecture/écriture. Toutefois, la modification de la valeur de cette propriété n'affecte que les connexions établies par la suite.

Voir aussi
Méthode Connection.Open

Propriété Connection.DefaultDatabase	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.DefaultDatabase = database

La propriété DefaultDatabase indique la base de données choisie par défaut pour la connexion active.
Type de données
String

Description
La propriété DefaultDatabase autorise l'application à spécifier la base de données par défaut pour un objet Connection. Toute syntaxe non qualifiée fait automatiquement référence à la base de données spécifiée par la propriété DefaultDatabase. Vous devez qualifier le nom des objets par le nom de la base de données souhaitée pour avoir accès aux autres bases de données.

Remarque
Les fournisseurs de données ne prennent pas tous en charge la propriété DefaultDatabase. Dans ce cas, ils peuvent générer une erreur ou renvoyer une valeur String vide.

Evénement Connection.Disconnect	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub Disconnect(adStatus As ADODB.EventStatusEnum, _ ByVal pConnection As ADODB.Connection)

L'événement Disconnect se déclenche une fois que la connexion est terminée.
Arguments
adStatus Une valeur EventStatusEnum indiquant l'état de l'opération en cours. Le paramètre adStatus est toujours défini sur adStatusOK lorsque l'événement est déclenché. Si le paramètre adStatus est défini sur adStatusUnwantedEvent, avant de quitter le code d'événement, cet événement n'est pas rappelé. pConnection L'objet Connection qui a déclenché cet événement.

Voir aussi
Evénement Connection.ConnectComplete, Enumération EventStatusEnum

Collection Connection.Errors	(Versions 2.0, 2.1, 2.5 et 2.6)

Set errors = connection.Errors

La collection Errors est un ensemble d'erreurs et d'avertissements individuels qui sont survenus au cours de la dernière opération sur l'objet Connection en cours.
Type de données
Errors (objet Collection)

Description
La propriété Errors de l'objet Connection est en lecture seule. Elle renvoie une référence à l'objet de la collection Errors pouvant contenir un ou plusieurs objets Error et indiquant des erreurs ADO ou des erreurs spécifiques au fournisseur.

Méthode Connection.Execute	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.Execute CommandText, RecordsAffected, Options Set recordset = connection.Execute(CommandText, RecordsAffected, Options)

La méthode Execute est utilisée pour exécuter une instruction SQL spécifiée, une requête, une procédure stockée, une URL ou une commande spécifique du fournisseur au niveau de la source de données.
Arguments
CommandText (String) Facultatif. Contient l'instruction SQL, la requête, la procédure stockée, l'URL ou la commande spécifique au fournisseur à exécuter. Le paramètre est similaire à la propriété Command.CommandText. RecordsAffected (Long) Facultatif. Contient le nombre d'enregistrements affectés par l'exécution de la commande. Options (Long) Facultatif. Représente une combinaison d'une ou de plusieurs valeurs CommandTypeEnum et ExecuteOptionEnum indiquant comment le fournisseur de données doit traiter la commande. La valeur par défaut est -1 (aucune option définie). Les valeurs d'énumération CommandTypeEnum et ExecuteOptionEnum figurent à l'annexe E.

Valeurs renvoyées
RecordsetObject

Description
La méthode Execute exécutes la commande spécifiée par le paramètre CommandText, qui à son tour est évalué selon le paramètre Options. A la fin de l'exécution de la commande, l'événement Connection.ExecuteComplete est déclenché. Si l'exécution de la commande renvoie des enregistrements, un nouvel objet Recordset est renvoyé depuis la méthode Execute. Si l'exécution de la commande ne renvoie pas d'enregistrements, un objet Recordset vide est renvoyé depuis la méthode Execute. Quel que soit le cas, l'objet Recordset renvoyé est toujours un curseur en avant seulement, en lecture seule. Lorsque le paramètre Options de la méthode Execute inclut une valeur adAsyncExecute, adAsyncFetch ou adAsyncFetchNonBlocking, les opérations se poursuivent dans l'arrière-plan du flux de l'application. Pendant que ces opérations se poursuivent, vous pouvez appeler la méthode Command.Cancel pour annuler toutes les opérations asynchrones en attente.

Remarque
Bien que la documentation ADO 2.6 (bétâ 2) indique que vous pouvez définir les arguments et la propriété CommandText sur une URL relative, notez que la valeur définie ici est sans importance. Si vous souhaitez obtenir le contenu d'un répertoire, vous devez spécifier ce répertoire dans la propriété ConnectionString. Quelle que soit la valeur spécifiée comme argument CommandText de la méthode Execute ou comme propriété CommandText de l'objet Connection, elle n'est pas prise en charge. Toutefois, si vous utilisez une chaîne String (") vide comme valeur, un message signalant que des erreurs se sont produites s'affiche. L'exemple suivant montre que la valeur de la propriété CommandText lors de l'appel à la méthode Execute est sans importance. Dim con As ADODB.Connection Dim rec As ADODB.Recordset Set con = New ADODB.Connection con.Open "URL=http://jroff_laptop/" Set rec = con.Execute("nothing really matters") ' ' rec contains contents of jroff_laptop ' rec.Close con.Close Set rec = Nothing Set con = Nothing

Voir aussi
Méthode Connection.Cancel, Propriété Command.CommandText, Evénement Connection.ExecuteComplete, Enumération CommandTypeEnum, Enumération ExecuteOptionEnum

Evénement Connection.ExecuteComplete	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub con_ExecuteComplete(ByVal RecordsAffected As Long, _ ByVal pError As ADODB.Error, _ adStatus As ADODB.EventStatusEnum, _ ByVal pCommand As ADODB.Command, _ ByVal pRecordset As ADODB.Recordset, _ ByVal pConnection As ADODB.Connection)

L'événement ExecuteComplete est appelé lorsque l'exécution d'une commande est terminée.
Arguments
RecordsAffected (Long) Indique le nombre d'enregistrements affectés par la commande exécutée. pError (Error) Contient les informations relatives à une erreur qui s'est produite si le paramètre adStatus est défini sur adStatusErrorsOccurred. adStatus (EventStatusEnum) Indique l'état de l'opération en cours. Si le paramètre adStatus est défini sur adStatusOK, l'opération a réussi. Si le paramètre adStatus est défini sur adStatusErrorsOccurred, l'opération a échoué et l'objet pError contient les informations relatives à l'erreur. Si le paramètre adStatus est défini sur adStatusUnwantedEvent, cet événement n'est pas rappelé. pCommand Représente l'objet Command qui a été exécuté (le cas échéant). pRecordset Représente l'objet Recordset résultant de l'exécution des commandes. Vous pouvez laisser cet objet Recordset vide. pConnection Représente l'objet Connection qui a déclenché cet événement.

Voir aussi
Méthode Connection.Execute, Méthode Command.Execute, Méthode Recordset.NextRecordset, Méthode Recordset.Open, Enumération EventStatusEnum

Evénement Connection.InfoMessage	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub InfoMessage(ByVal pError As ADODB.Error, _ adStatus As ADODB.EventStatusEnum, _ ByVal pConnection As ADODB.Connection)

L'événement InfoMessage se déclenche lorsque un avertissement se produit pendant une opération ConnectionEvent.
Arguments
pError Un objet Error contenant les informations relatives à une erreur qui s'est produite, si le paramètre adStatus est défini sur adStatusErrorsOccurred. adStatus Une valeur EventStatusEnum indiquant l'état de l'opération en cours. Si le paramètre adStatus est défini sur adStatusOK, l'opération a réussi. Si le paramètre adStatus est défini sur adStatusErrorsOccurred, l'opération a échoué et l'objet pError contient les informations relatives à l'erreur. Si le paramètre adStatus est défini sur adStatusUnwantedEvent, cet événement n'est pas rappelé. pRecordset L'objet Recordset qui a appelé cet événement.

Voir aussi
Enumération EventStatusEnum

Propriété Connection.IsolationLevel	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.IsolationLevel = IsolationLevelEnum

La propriété Isolation permet de définir le niveau d'isolation utilisé lorsque vous appliquez la gestion des transactions.
Type de données
IsolationLevelEnum (Long)

Description
La propriété IsolationLevel est en lecture/écriture. Si vous avez modifié la valeur de cette propriété, les effets ne deviennent apparents que lorsque vous appelez la méthode BeginTrans. Si le fournisseur de données ne peut pas accorder le niveau d'isolation requis, alors le niveau suivant sera défini automatiquement. La propriété IsolationLevel peut être définie sur l'une des énumérations ParameterDirectionEnum figurant dans l'annexe E.

Voir aussi
Méthode Connection.BeginTrans, Enumération IsolationLevelEnum

Propriété Connection.Mode	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.Mode = ConnectModeEnum

La propriété Mode identifie les permissions accordées pour la modification des données dans le cadre de la connexion spécifiée.
Type de données
ConnectModeEnum (Long)

Description
La propriété Mode est en lecture/écriture lorsque l'objet Connection est fermé et en lecture seule lorsque l'objet est ouvert. La propriété Mode peut être définie sur l'une des énumérations ConnectModeEnum figurant dans l'annexe E.

Méthode Connection.Open	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.Open ConnectionString, UserID, Password, Options

La méthode Open pour l'objet Connection ouvre une connexion à une source de données spécifique. La méthode Open pour l'objet Recordset ouvre un curseur.
Arguments
ConnectionString (String) Facultatif. Contient les informations nécessaires à la connexion de l'objet ADO au fournisseur de données. Cette propriété est mappée sur la propriété Connection.ConnectionString. UserID (String) Facultatif. Contient le nom d'utilisateur nécessaire pour établir la connexion recherchée. Password (String) Facultatif. Contient le mot de passe nécessaire pour établir la connexion recherchée. Options (Long) Facultatif. Représente une valeur d'énumération ConnectOptionEnum. Actuellement, la seule valeur définie pour l'énumération ConnectOptionEnum est adAsyncConnect (16) qui charge l'objet ADO d'établir la connexion à la source de données de manière asynchrone. La valeur par défaut est -1 (aucune option définie).

Description
La méthode Open établit la connexion à une source de données. Une fois la connexion établie, vous pouvez émettre des commandes au niveau du fournisseur de données et obtenir des informations de la source de données. La connexion au fournisseur de données peut être établie de manière asynchrone en transmettant la valeur adConnectAsync au paramètre Options de la méthode Open. Une fois l'opération démarrée, l'application peut appeler la méthode Connection.Cancel pour annuler la connexion asynchrone en attente si l'application constate que la connexion prend trop long. La connexion au fournisseur de données est définie par la valeur du paramètre ConnectionString. D'autre part, les paramètres UserName et Password authentifient l'utilisateur au sein du fournisseur de données. Il est possible de définir les valeurs UserName et Password dans le paramètre ConnectionString et comme paramètres de la méthode Open. Dans ce cas, les paramètres remplaceront ceux spécifiés dans la propriété ConnectionString. Le paramètre ConnectionString remplace toute valeur définie précédemment sur la propriété Connection.ConnectionString. En général, la propriété ConnectionString contient des informations plus détaillées sur la connexion que vous pouvez transmettre par le paramètre ConnectionString de la méthode Open. Il est conseillé de lire la propriété ConnectionString pour voir ce détail supplémentaire. Le paramètre ConnectionString, comme la propriété ConnectionString, est composé des services des instructions argument=value, séparés par un point-virgule. Les arguments utilisés dans le paramètre (et la propriété) ConnectionString dépendent entièrement du fournisseur de données auquel vous vous connectez. La méthode Connection.Close est utilisée pour fermer un objet Connection ouvert, une fois que l'application n'en a plus besoin. Un objet Connection fermé peut être modifié et rouvert. Pour effacer l'objet Connection de la mémoire dans Visual Basic, celui-ci doit être défini sur Nothing.

Voir aussi
Méthode Connection.Cancel, Méthode Connection.Close, Propriété Connection.ConnectionString, Enumération ConnectModeEnum, Enumération ConnectOptionEnum

Connection.OpenSchema	(Versions 2.0, 2.1, 2.5 et 2.6)

Set recordset = connection.OpenSchema(Schema, Criteria, SchemaID)

La méthode OpenSchema renvoie un objet Recordset contenant des informations sur le schéma de la source de données.
Arguments
Schema (SchemaEnum) Indique le type de schéma qui sera fourni par la méthode OpenSchema dans l'objet Recordset renvoyé. L'argument SchemaEnum contient les valeurs d'énumération figurant au tableau F-1. Criteria (tableau Variant) Facultatif. Indique les colonnes de contraintes à utiliser pour le schéma requis. La liste des colonnes de contraintes pour chaque type de schéma figure au tableau G-1. SchemaID (Long) Facultatif. Représente l'identificateur GUID d'une requête de schéma spécifique au fournisseur. Si le paramètre Schema est défini sur adSchemaProviderSpecific (-1), alors ce paramètre est obligatoire; autrement, il n'est pas utilisé.

Description
La méthode OpenSchema est utilisée pour obtenir des informations sur la structure d'une source de données (le schéma). Lorsque le paramètre Schema est défini sur une valeur SchemaEnum, l'objet ADO est en mesure de déterminer les informations requises par l'application. D'autre part, vous pouvez définir le paramètre Criteria pour affiner la recherche. Par exemple, si la valeur d'énumération adSchemaTables est transmise, la méthode OpenSchema renvoie uniquement les noms de tableaux. Certains fournisseurs de données prennent en charge leurs propres types de requêtes de schéma. Pour utiliser cette fonction, vous devez définir le paramètre Schema sur adSchemaProviderSpecific, et le paramètre SchemaID sur l'identificateur GUID de la requête de schéma spécifique au fournisseur. Si le paramètre Schema est défini sur la valeur adSchemaProviderSpecific, et que le paramètre SchemaID n'est pas spécifié, une erreur survient. Tous les fournisseurs ne prennent pas en charge toutes les requêtes de schéma définies au tableau G-1. En fait, uniquement les requêtes adSchemaTables, adSchemaColumns et adSchemaProviderTypes sont prises en charge par tous les fournisseurs. Toutefois, cela ne garantit pas la prise en charge des colonnes de contraintes.

Voir aussi
Enumération SchemaEnum

Collection Connection.Properties	(Versions 2.0, 2.1, 2.5 et 2.6)

Set properties = connection.Properties

La collection Properties contient des caractéristiques spécifiques à l'objet Connection 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 Connection pour le fournisseur de données. La collection Properties de l'objet Connection contient uniquement les propriétés suivantes jusqu'à l'ouverture de la connexion : Password (Mot de passe) Persist Security Info (Informations de sécurité persistente) User ID (ID utilisateur) Data Source (Source de données) Window Handle (Poignée de fenêtre) Location (Emplacement) Mode (Mode) Prompt (Invite) Connect Timeout (Temporisation de la connexion) Extended Properties (Propriétés étendues) Locale Identifier (Identificateur régional) Initial Catalog (Catalogue initial) OLE DB Services (Services OLE DB) General Timeout (Temporisation générale)

Propriété Connection.Provider	(Versions 2.0, 2.1, 2.5 et 2.6)

connection.Provider = provider

La propriété Provider indique le nom du fournisseur de données pour l'objet Connection en cours.
Type de données
String

Description
La propriété Provider définit le fournisseur pour l'objet Connection en cours. Vous pouvez également la spécifier dans la propriété ConnectionString de l'objet Connection ou l'argument ConnectionString sur la méthode Open de l'objet Connection. Il est recommandé de ne spécifier le fournisseur qu'à l'un de ces emplacements, car les résultats peuvent être imprévisibles. La propriété Provider de l'objet Connection est en lecture/écriture lorsque l'objet Connection associé est fermé et en lecture seule lorsqu'il est ouvert. La propriété Provider n'est utilisée que lorsque l'objet Connection est ouvert ou que la collection Properties de l'objet Connection est utilisée. Si vous ne spécifiez pas de fournisseur, l'objet ADO indique la valeur par défaut MSDASQL, le fournisseur ODBC Microsoft pour OLE DB.

Voir aussi
Propriété Connection.ConnectionString, Méthode Connection.Open

Méthode Connection.RollbackTrans	(Versions 2.0, 2.1, 2.5 et 2.6)



s Voir la méthode Connection.BeginTrans.

Evénement Connection.RollbackTransComplete	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub con_RollbackTransComplete(ByVal pError As ADODB.Error, _ adStatus As ADODB.EventStatusEnum, _ ByVal pConnection As ADODB.Connection)

L'événement RollbackTransComplete est déclenché lorsque la méthode RollbackTrans a terminé son opération.
Arguments
pError Un objet Error contenant les informations relatives à une erreur qui s'est produite, si le paramètre adStatus est défini sur adStatusErrorsOccurred. adStatus Une valeur EventStatusEnum indiquant l'état de l'opération en cours. Si le paramètre adStatus est défini sur adStatusOK, l'opération a réussi. Si le paramètre adStatus est défini sur adStatusErrorsOccurred, l'opération a échoué et l'objet pError contient les informations relatives à l'erreur. Si le paramètre adStatus est défini sur adStatusUnwantedEvent, cet événement n'est pas rappelé. pConnection L'objet Connection qui a déclenché cet événement.

Voir aussi
Evénement Connection.BeginTransComplete, Evénement Connection.CommitTransComplete, Méthode Connection.RollbackTrans, Enumération EventStatusEnum

Propriété Connection.State	(Versions 2.0, 2.1, 2.5 et 2.6)

state = connection.State

La propriété State indique l'état actuel d'un objet Command, Connection, Record, Recordset ou Stream.
Type de données
ObjectStateEnum (Long)

Description
La propriété State renvoie une combinaison des valeurs ObjectStateEnum figurant à l' annexe E, indiquant l'état actuel d'un objet.

Voir aussi
Enumération ObjectStateEnum

Propriété Connection.Version	(Versions 2.0, 2.1, 2.5 et 2.6)

version = connection.Version

La propriété Version indique la version de l'objet ADO en cours d'utilisation.
Type de données
String

Description
La propriété Version renvoie les informations sur la version de l'objet ADO que vous utilisez dans votre application, sous forme d'une chaîne.

Evénement Connection.WillConnect	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub WillConnect(ConnectionString As String, _ UserID As String, _ Password As String, _ Options As Long, _ adStatus As ADODB.EventStatusEnum, _ ByVal pConnection As ADODB.Connection)

L'événement WillConnect est déclenché avant l'établissement de la connexion.
Arguments
ConnectionString (String) Contient les informations sur la connexion pour l'opération de connexion en attente. UserID (String) Contient le nom d'utilisateur pour l'opération de connexion en attente. Password (String) Contient le mot de passe pour l'opération de connexion en attente. Options (Long) Indique comment procéder à l'évaluation du paramètre ConnectionString. Ce paramètre n'accepte que la valeur adAsyncOpen. adStatus (EventStatusEnum) Indique l'état de l'opération en cours. Le paramètre adStatus est défini sur adStatusOK si l'opération à l'origine de cet événement a réussi. Si le paramètre adStatus est défini sur adStatusCantDeny, l'événement ne peut demander l'annulation de l'opération. Si le paramètre adStatus est défini sur adStatusUnwantedEvent, cet événement n'est pas rappelé. Si le paramètre adStatus est défini sur adStatusCancel, une demande d'annulation de l'opération est faite. pConnection Représente l'objet Connection qui a déclenché cet événement.

Remarque
L'application peut modifier les paramètres ConnectionString, UserID et Password dans cet événement avant que l'exécution de l'opération ne soit terminée.

Voir aussi
Evénement Connection.ConnectComplete, Enumération EventStatusEnum

Evénement Connection.WillExecute	(Versions 2.0, 2.1, 2.5 et 2.6)

Private Sub WillExecute(Source As String, _ CursorType As ADODB.CursorTypeEnum, _ LockType As ADODB.LockTypeEnum, _ Options As Long, _ adStatus As ADODB.EventStatusEnum, _ ByVal pCommand As ADODB.Command, _ ByVal pRecordset As ADODB.Recordset, _ ByVal pConnection As ADODB.Connection)

L'événement WillExecute est appelé avant le début de l'exécution d'une commande.
Arguments
Source (String) Contient la source de la commande à exécuter. En général, cette valeur est une instruction SQL ou un nom de procédure stockée. CursorType (CursorTypeEnum) Indique le type d'objet Recordset qui sera ouvert. Vous pouvez modifier cette valeur dans l'événement pour changer le type de curseur qui sera utilisé lorsque vous appelez la méthode Recordset.Open. Ce paramètre est ignoré pour toutes les autres méthodes entraînant cet événement. LockType (LockTypeEnum) Indique le modèle de verrouillage qui sera utilisé à l'ouverture de l'objet Recordset. Vous pouvez modifier cette valeur dans l'événement pour changer le modèle de verrouillage qui sera utilisé lorsque vous appelez la méthode Recordset.Open. Ce paramètre est ignoré pour toutes les autres méthodes entraînant cet événement. Options (Long) Indique toutes les autres options utilisées pour exécuter la commande ou ouvrir le jeu d'enregistrements. adStatus (EventStatusEnum) Indique l'état de l'opération en cours. Le paramètre adStatus est défini sur adStatusOK si l'opération à l'origine de cet événement a réussi. Si le paramètre adStatus est défini sur adStatusCantDeny, l'événement ne peut demander l'annulation de l'opération. Si le paramètre adStatus est défini sur adStatusUnwantedEvent, cet événement n'est pas rappelé. Si le paramètre adStatus est défini sur adStatusCancel, une demande d'annulation de l'opération est faite. pCommand Représente l'objet Command auquel s'applique cet événement. La valeur est définie sur Nothing si l'événement a été appelé à cause d'une méthode Connection.Execute ou Recordset.Open. pRecordset Représente l'objet Recordset auquel s'applique cet événement. La valeur est définie sur Nothing si l'événement a été appelé à cause d'une méthode Connection.Execute ou Command.Execute. pConnection Représente l'objet Connection qui a déclenché cet événement.

Voir aussi
Méthode Connection.Execute, Méthode Command.Execute, Méthode Recordset.Open, Enumération EventStatusEnum, Enumération LockTypeEnum