Exporter (0) Imprimer
Développer tout

OdbcConnection, classe

Mise à jour : novembre 2007

Représente une connexion ouverte à une source de données.

Espace de noms :  System.Data.Odbc
Assembly :  System.Data (dans System.Data.dll)

public sealed class OdbcConnection : DbConnection, 
	ICloneable
public final class OdbcConnection extends DbConnection implements ICloneable
public final class OdbcConnection extends DbConnection implements ICloneable

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 la modularité 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. L'utilisateur peut toutefois 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é à l'aide de 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 Sécurité d'accès du code et ADO.NET.

Pour plus d'informations sur la gestion des messages d'avertissement et d'information à partir de la source de données, consultez Événements de connexion (ADO.NET).

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


Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft