OdbcConnection OdbcConnection OdbcConnection OdbcConnection Class

Definição

Representa uma conexão aberta com uma fonte de dados.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
Herança
Implementações

Exemplos

O exemplo a seguir cria OdbcCommand um e OdbcConnectionum.The following example creates an OdbcCommand and an OdbcConnection. O OdbcConnection é aberto e definido como a Connection propriedade.The OdbcConnection is opened and set as the Connection property. Em seguida, o ExecuteNonQueryexemplo chama e fecha a conexão.The example then calls ExecuteNonQuery, and closes the connection. Para fazer isso, o ExecuteNonQuery é passado uma cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução 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

Comentários

Um OdbcConnection objeto representa uma conexão exclusiva com uma fonte de dados criada usando uma cadeia de conexão ou um DSN (nome da fonte de dados) ODBC.An OdbcConnection object represents a unique connection to a data source created by using a connection string or ODBC data source name (DSN). Com um sistema de banco de dados cliente/servidor, é equivalente a uma conexão de rede com o servidor.With a client/server database system, it is equivalent to a network connection to the server. Dependendo da funcionalidade suportada pelo driver ODBC nativo, alguns métodos ou propriedades de um OdbcConnection objeto podem não estar disponíveis.Depending on the functionality supported by the native ODBC driver, some methods or properties of an OdbcConnection object may not be available.

O OdbcConnection objeto usa recursos nativos, como o ambiente ODBC e identificadores de conexão.The OdbcConnection object uses native resources such as ODBC environment and connection handles. Você sempre deve fechar explicitamente todos os OdbcConnection objetos abertos chamando Close ou descartar antes que o OdbcConnection objeto saia do escopo ou colocando a conexão dentro de Using uma instrução.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. Não fazer isso deixa a liberação desses recursos nativos para a coleta de lixo.Not doing this leaves the freeing of these native resources to garbage collection. Ele pode não liberá-los imediatamente.It might not free them immediately. Isso, por sua vez, pode eventualmente fazer com que o driver subjacente fique sem recursos ou alcance um limite máximo.This, in turn, can eventually cause the underlying driver to run out of resources or reach a maximum limit. Isso resultou em falhas intermitentes.This has resulted in intermittent failures. Por exemplo, você pode encontrar Maximum Connections erros relacionados enquanto muitas conexões estão aguardando para serem excluídas pelo coletor de lixo.For example, you might experience Maximum Connections -related errors while many connections are waiting to be deleted by the garbage collector. O fechamento explícito das conexões permite um uso mais eficiente de recursos nativos, aprimorando a escalabilidade e melhorando o desempenho geral do aplicativo.Explicitly closing the connections allows for a more efficient use of native resources, enhancing scalability and improving overall application performance.

Observação

Para implantar aplicativos de alto desempenho, você frequentemente deve usar o pool de conexões.To deploy high-performance applications, you frequently must use connection pooling. No entanto, quando você usa o .NET Framework Provedor de Dados para ODBC, não é necessário habilitar o pool de conexões porque o provedor o gerencia automaticamente.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.

Se um dos Execute métodos OdbcCommand da classe causar um fatal OdbcException (por exemplo, um nível de severidade de SQL Server de 20 ou mais), o OdbcConnection pode fechar.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. No entanto, o usuário pode reabrir a conexão e continuar.However, the user can reopen the connection and continue.

Um aplicativo que cria uma instância do OdbcConnection objeto pode exigir que todos os chamadores diretos e indiretos tenham permissão suficiente para o código definindo as demandas de segurança declarativas ou imperativas.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. OdbcConnectioncria demandas de segurança usando OdbcPermission o objeto.OdbcConnection creates security demands by using the OdbcPermission object. Os usuários podem verificar se o código tem permissões suficientes usando o OdbcPermissionAttribute objeto.Users can verify that their code has sufficient permissions by using the OdbcPermissionAttribute object. Os usuários e os administradores também podem usar a ferramenta de política de segurança de acesso do código (Caspol. exe) para modificar a política de segurança nos níveis de computador, usuário e empresa.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. Para obter mais informações, consulte Segurança de acesso do código e ADO.NET.For more information, see Code Access Security and ADO.NET.

Para obter mais informações sobre como tratar mensagens de aviso e informativas da fonte de dados, consulte eventos de conexão.For more information about handling warning and informational messages from the data source, see Connection Events.

Construtores

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

Inicializa uma nova instância da classe OdbcConnection.Initializes a new instance of the OdbcConnection class.

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

Inicializa uma nova instância da classe OdbcConnection com a cadeia de conexão especificada.Initializes a new instance of the OdbcConnection class with the specified connection string.

Propriedades

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

Obtém ou define a cadeia de caracteres usada para abrir uma fonte de dados.Gets or sets the string used to open a data source.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Obtém ou define o tempo de espera durante a tentativa de estabelecimento da conexão, antes que a tentativa seja terminada e um erro seja gerado.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

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Database Database Database Database

Obtém o nome do banco de dados atual ou o banco de dados a ser usado após uma conexão ser aberta.Gets the name of the current database or the database to be used after a connection is opened.

DataSource DataSource DataSource DataSource

Obtém o nome do servidor ou o nome de arquivo da fonte de dados.Gets the server name or file name of the data source.

DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Driver Driver Driver Driver

Obtém o nome do driver ODBC especificado para a conexão atual.Gets the name of the ODBC driver specified for the current connection.

Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ServerVersion ServerVersion ServerVersion ServerVersion

Obtém uma cadeia de caracteres que contém a versão do servidor ao qual o cliente está conectado.Gets a string that contains the version of the server to which the client is connected.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Obtém o estado atual da conexão.Gets the current state of the connection.

Métodos

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

Inicia uma transação na fonte de dados.Starts a transaction at the data source.

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

Inicia uma transação na fonte de dados com o valor IsolationLevel especificado.Starts a transaction at the data source with the specified IsolationLevel value.

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

Altera o banco de dados atual associado a um OdbcConnection aberto.Changes the current database associated with an open OdbcConnection.

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

Fecha a conexão com a fonte de dados.Closes the connection to the data source.

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

Cria e retorna um objeto OdbcCommand associado ao OdbcConnection.Creates and returns an OdbcCommand object associated with the OdbcConnection.

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

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.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()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

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

Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados.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)

Inscreve-se na transação especificada como uma transação distribuída.Enlists in the specified transaction as a distributed transaction.

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

Inscreve-se na transação especificada como uma transação distribuída.Enlists in the specified transaction as a distributed transaction.

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

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

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

Serve como a função de hash padrão.Serves as the default hash function.

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

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Retorna informações de esquema para a fonte de dados deste OdbcConnection.Returns schema information for the data source of this OdbcConnection.

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

Retorna informações de esquema para a fonte de dados deste OdbcConnection usando o nome especificado para o nome do esquema.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[])

Retorna informações de esquema para a fonte de dados desse OdbcConnection usando a cadeia de caracteres especificada para o nome do esquema e a matriz de cadeia de caracteres especificada para os valores de restrição.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)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

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

Obtém o Type da instância atual.Gets the Type of the current instance.

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

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

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

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

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

Abre uma conexão com uma fonte de dados com as configurações de propriedade especificadas pelo ConnectionString.Opens a connection to a data source with the property settings specified by the ConnectionString.

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

Indica que o identificador de ambiente do Gerenciador de Driver ODBC pode ser liberado quando a última conexão subjacente é liberada.Indicates that the ODBC Driver Manager environment handle can be released when the last underlying connection is released.

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

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Inherited from Component)

Eventos

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
InfoMessage InfoMessage InfoMessage InfoMessage

Ocorre quando o driver ODBC envia um aviso ou uma mensagem informativa.Occurs when the ODBC driver sends a warning or an informational message.

StateChange StateChange StateChange StateChange

Ocorre quando o estado da conexão é alterado.Occurs when the state of the connection changes.

Implantações explícitas de interface

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

Para obter uma descrição desse membro, consulte Clone().For a description of this member, see Clone().

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

Inicia uma transação de banco de dados.Begins a database transaction.

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

Inicia uma transação de banco de dados com o nível de isolamento especificado.Begins a database transaction with the specified isolation level.

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

Cria e retorna um objeto de comando associado com a conexão.Creates and returns a command object associated with the connection.

Aplica-se a

Veja também