OdbcConnection OdbcConnection OdbcConnection OdbcConnection Class

Définition

Représente une connexion ouverte à une source de données.Represents an open connection to a data source.

public ref class OdbcConnection sealed : System::Data::Common::DbConnection, ICloneable
public sealed class OdbcConnection : System.Data.Common.DbConnection, ICloneable
type OdbcConnection = class
    inherit DbConnection
    interface ICloneable
Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable
Héritage
Implémente

Exemples

L’exemple suivant crée un OdbcCommand et un OdbcConnection.The following example creates an OdbcCommand and an OdbcConnection. Le OdbcConnection est ouvert et défini en tant que le Connection propriété.The OdbcConnection is opened and set as the Connection property. L’exemple appelle ensuite ExecuteNonQueryet ferme la connexion.The example then calls ExecuteNonQuery, and closes the connection. Pour ce faire, le ExecuteNonQuery est passée à une chaîne de connexion et une chaîne de requête qui est une instruction SQL INSERT.To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is an SQL INSERT statement.

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.
	}
}
Private Sub InsertRow(ByVal connectionString As String)

    Dim queryString As String = _
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')"
    Dim command As New OdbcCommand(queryString)

    Using connection As New OdbcConnection(connectionString)
        command.Connection = connection
        connection.Open()
        command.ExecuteNonQuery()

        ' The connection is automatically closed at 
        ' the end of the Using block.
    End Using
End Sub

Remarques

Un OdbcConnection objet représente une connexion unique à une source de données créée à l’aide d’une chaîne de connexion ou le nom de source de données ODBC (DSN).An OdbcConnection object represents a unique connection to a data source created by using a connection string or ODBC data source name (DSN). Avec un système de base de données client/serveur, il est équivalent à une connexion réseau au serveur.With a client/server database system, it is equivalent to a network connection to the server. Selon les fonctionnalités prises en charge par le pilote ODBC natif, certaines méthodes et les propriétés d’un OdbcConnection objet n’est peut-être pas disponible.Depending on the functionality supported by the native ODBC driver, some methods or properties of an OdbcConnection object may not be available.

Le OdbcConnection objet utilise des ressources natives telles que les handles d’environnement et de connexion ODBC.The OdbcConnection object uses native resources such as ODBC environment and connection handles. Vous devez toujours fermer explicitement ouverts OdbcConnection objets en appelant Close ou Dispose avant la OdbcConnection objet ne passe hors de portée, ou en plaçant la connexion dans un Using instruction.You should always explicitly close any open OdbcConnection objects by calling Close or Dispose before the OdbcConnection object goes out of scope, or by placing the connection within a Using statement. Ne pas de cette opération laisse la libération de ces ressources natives au garbage collection.Not doing this leaves the freeing of these native resources to garbage collection. Il ne peut pas les libérer immédiatement.It might not free them immediately. Cela, à son tour, peut provoquer le pilote sous-jacent de manquer de ressources ou d’atteindre une limite maximale.This, in turn, can eventually cause the underlying driver to run out of resources or reach a maximum limit. Cela a entraîné des échecs intermittents.This has resulted in intermittent failures. Par exemple, vous pouvez rencontrer Maximum Connections -erreurs liées au tandis que le nombre de connexions en attente d’être supprimé par le garbage collector.For example, you might experience Maximum Connections -related errors while many connections are waiting to be deleted by the garbage collector. Fermeture explicite des connexions permet une utilisation plus efficace des ressources natives, améliorant l’évolutivité et les performances globales de l’application.Explicitly closing the connections allows for a more efficient use of native resources, enhancing scalability and improving overall application performance.

Notes

Pour déployer des applications hautes performances, vous devez fréquemment utiliser le regroupement de connexions.To deploy high-performance applications, you frequently must use connection pooling. Toutefois, lorsque vous utilisez le fournisseur de données .NET Framework pour ODBC, il est inutile activer le regroupement de connexions, car le fournisseur gère automatiquement.However, when you use the .NET Framework Data Provider for ODBC, you do not have to enable connection pooling because the provider manages this automatically.

Si un de le Execute méthodes de la OdbcCommand classe provoque une erreur fatale OdbcException (par exemple, un SQL Server niveau de gravité 20 ou supérieur), le OdbcConnection peut se fermer.If one of the Execute methods of the OdbcCommand class causes a fatal OdbcException (for example, a SQL Server severity level of 20 or greater), the OdbcConnection may close. L'utilisateur peut toutefois rouvrir la connexion et continuer.However, the user can reopen the connection and continue.

Une application qui crée une instance de la OdbcConnection objet peut exiger de tous les appelants directs et indirects dispose des autorisations suffisantes pour le code en définissant des demandes de sécurité déclaratives ou impératives.An application that creates an instance of the OdbcConnection object can require all direct and indirect callers to have sufficient permission to the code by setting declarative or imperative security demands. OdbcConnection crée des demandes de sécurité à l’aide de la OdbcPermission objet.OdbcConnection creates security demands by using the OdbcPermission object. Les utilisateurs peuvent vérifier que leur code dispose des autorisations suffisantes à l’aide de la OdbcPermissionAttribute objet.Users can verify that their code has sufficient permissions by using the OdbcPermissionAttribute object. Aux utilisateurs et administrateurs peuvent également utiliser Code Access Security Policy Tool (Caspol.exe) pour modifier la stratégie de sécurité à l’ordinateur, utilisateur, niveaux de l’entreprise.Users and administrators can also use the Code Access Security Policy Tool (Caspol.exe) to modify security policy at the computer, user, and enterprise levels. Pour plus d'informations, consultez Code Access Security and ADO.NET.For more information, see Code Access Security and ADO.NET.

Pour plus d’informations sur la gestion des messages d’avertissement et d’informations à partir de la source de données, consultez les événements de connexion.For more information about handling warning and informational messages from the data source, see Connection Events.

Constructeurs

OdbcConnection() OdbcConnection() OdbcConnection() OdbcConnection()

Initialise une nouvelle instance de la classe OdbcConnection.Initializes a new instance of the OdbcConnection class.

OdbcConnection(String) OdbcConnection(String) OdbcConnection(String) OdbcConnection(String)

Initialise une nouvelle instance de la OdbcConnection classe avec la chaîne de connexion spécifiée.Initializes a new instance of the OdbcConnection class with the specified connection string.

Propriétés

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

Obtient ou définit la chaîne utilisée pour ouvrir une source de données.Gets or sets the string used to open a data source.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Obtient ou définit le délai d’attente lors de la tentative établir une connexion avant d’abandonner la tentative et de générer une erreur.Gets or sets the time to wait while trying to establish a connection before terminating the attempt and generating an error.

Container Container Container Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Database Database Database Database

Obtient le nom de la base de données active ou de la base de données à utiliser une fois la connexion ouverte.Gets the name of the current database or the database to be used after a connection is opened.

DataSource DataSource DataSource DataSource

Obtient le nom du serveur ou le nom de fichier de la source de données.Gets the server name or file name of the data source.

DesignMode DesignMode DesignMode DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Driver Driver Driver Driver

Obtient le nom du pilote ODBC spécifié pour la connexion actuelle.Gets the name of the ODBC driver specified for the current connection.

Events Events Events Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ServerVersion ServerVersion ServerVersion ServerVersion

Obtient une chaîne qui contient la version du serveur auquel le client est connecté.Gets a string that contains the version of the server to which the client is connected.

Site Site Site Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Obtient l’état actuel de la connexion.Gets the current state of the connection.

Méthodes

BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

Commence une transaction dans la source de données.Starts a transaction at the data source.

BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel)

Commence une transaction dans la source de données avec la valeur IsolationLevel valeur.Starts a transaction at the data source with the specified IsolationLevel value.

ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

Modifie la base de données actuel associé à une ouverture OdbcConnection.Changes the current database associated with an open OdbcConnection.

Close() Close() Close() Close()

Ferme la connexion à la source de données.Closes the connection to the data source.

CreateCommand() CreateCommand() CreateCommand() CreateCommand()

Crée et retourne un OdbcCommand objet associé à la OdbcConnection.Creates and returns an OdbcCommand object associated with the OdbcConnection.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction)

S’inscrit dans la transaction spécifiée en tant que transaction distribuée.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

S’inscrit dans la transaction spécifiée en tant que transaction distribuée.Enlists in the specified transaction as a distributed transaction.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSchema() GetSchema() GetSchema() GetSchema()

Retourne les informations de schéma pour la source de données de ce OdbcConnection.Returns schema information for the data source of this OdbcConnection.

GetSchema(String) GetSchema(String) GetSchema(String) GetSchema(String)

Retourne des informations de schéma pour la source de données de ce OdbcConnection en utilisant le nom spécifié pour le nom de schéma.Returns schema information for the data source of this OdbcConnection using the specified name for the schema name.

GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[])

Retourne les informations de schéma pour la source de données de ce OdbcConnection à l’aide de la chaîne spécifiée pour le nom de schéma et du tableau de chaînes spécifié pour les valeurs de restriction.Returns schema information for the data source of this OdbcConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Open() Open() Open() Open()

Ouvre une connexion à une source de données avec les paramètres de propriété spécifiés par le ConnectionString.Opens a connection to a data source with the property settings specified by the ConnectionString.

ReleaseObjectPool() ReleaseObjectPool() ReleaseObjectPool() ReleaseObjectPool()

Indique que le handle d’environnement Gestionnaire de pilotes ODBC peut être libéré lorsque la dernière connexion sous-jacente est libérée.Indicates that the ODBC Driver Manager environment handle can be released when the last underlying connection is released.

ToString() ToString() ToString() ToString()

Retourne un String contenant le nom du Component, s’il en existe un.Returns a String containing the name of the Component, if any. Cette méthode ne doit pas être remplacée.This method should not be overridden.

(Inherited from Component)

Événements

Disposed Disposed Disposed Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
InfoMessage InfoMessage InfoMessage InfoMessage

Se produit lorsque le pilote ODBC envoie un avertissement ou un message d’information.Occurs when the ODBC driver sends a warning or an informational message.

StateChange StateChange StateChange StateChange

Se produit lorsque l’état de la connexion.Occurs when the state of the connection changes.

Implémentations d’interfaces explicites

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

Pour obtenir une description de ce membre, consultez Clone().For a description of this member, see Clone().

IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction()

Commence une transaction de base de données.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec le niveau d’isolation spécifié.Begins a database transaction with the specified isolation level.

IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand()

Crée et retourne un objet command associé à la connexion.Creates and returns a command object associated with the connection.

S’applique à

Voir aussi