OdbcConnection, classe

Objet OdbcConnection représentant une connexion unique à une source de données créée à l'aide d'une chaîne de connexion ou d'un nom de source de données ODBC (DSN). Avec un système de base de données client/serveur, il équivaut à une connexion réseau au serveur. Selon les fonctionnalités prises en charge par le pilote ODBC natif, il se peut que certaines méthodes ou propriétés d'un objet OdbcConnection ne soient pas disponibles.

L'objet OdbcConnection utilise des ressources natives, telles que l'environnement ODBC et les handles de connexion. Vous devez toujours fermer explicitement tous les objets OdbcConnection ouverts en appelant Close ou Dispose avant que l'objet OdbcConnection ne passe hors de portée, ou en plaçant la connexion dans une instruction Using. Sinon, c'est le garbage collection qui se charge de libérer ces ressources natives, ce qui peut prendre du temps. Dans ces conditions, le pilote sous-jacent risque de manquer de ressources ou d'atteindre une limite maximale, d'où des échecs sporadiques. Par exemple, vous pouvez rencontrer des erreurs liées à Maximum Connections pendant que de nombreuses connexions attendent d'être supprimées par le garbage collector. La fermeture explicite des connexions permet une utilisation plus rationnelle des ressources natives, ce qui renforce l'extensibilité et améliore les performances globales des applications.

Remarque
Pour déployer des applications hautes performances, vous devez fréquemment utiliser le regroupement de connexion. Cependant, lorsque vous utilisez le fournisseur de données .NET Framework pour ODBC, vous n'avez pas besoin d'activer le regroupement de connexion, car le fournisseur le gère automatiquement.

Si l'une des méthodes Execute de la classe OdbcCommand provoque un OdbcException irrécupérable (par exemple, un niveau de gravité SQL Server égal ou supérieur à 20), OdbcConnection risque de se fermer. Toutefois, l'utilisateur peut rouvrir la connexion et continuer.

Une application qui crée une instance de l'objet OdbcConnection peut exiger que tous les appelants directs et indirects possèdent l'autorisation suffisante pour le code en définissant des demandes de sécurité déclaratives ou impératives. OdbcConnection crée des demandes de sécurité en utilisant l'objet OdbcPermission. Les utilisateurs peuvent vérifier que leur code possède les autorisations suffisantes à l'aide de l'objet OdbcPermissionAttribute. Les utilisateurs et administrateurs peuvent également utiliser l'outil Stratégie de sécurité d'accès du code (Code Access Security Policy Tool, Caspol.exe) pour modifier la stratégie de sécurité au niveau de l'ordinateur, de l'utilisateur et de l'entreprise. Pour plus d'informations, consultez Code Access Security and ADO.NET.

Pour plus d'informations sur la gestion des messages d'avertissement et d'information à partir de la source de données, consultez Working with Connection Events.

L'exemple suivant crée OdbcCommand et OdbcConnection. OdbcConnection est ouvert et défini en tant que propriété Connection. L'exemple appelle ensuite ExecuteNonQuery et ferme la connexion. Pour effectuer cette opération, une chaîne de connexion et une chaîne de requête qui est une instruction SQL INSERT sont passées à ExecuteNonQuery.

		static private void InsertRow(string connectionString)
		{
			string queryString = 
                "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";
			OdbcCommand command = new OdbcCommand(queryString);

			using (OdbcConnection connection = new OdbcConnection(connectionString))
			{
				command.Connection = connection;
				connection.Open();
				command.ExecuteNonQuery();

                // The connection is automatically closed at 
                // the end of the Using block.
			}
		}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources