OdbcConnection Classe

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 um OdbcCommand e um OdbcConnection.The following example creates an OdbcCommand and an OdbcConnection. O OdbcConnection é aberto e definido como a propriedade Connection.The OdbcConnection is opened and set as the Connection property. Em seguida, o exemplo chama ExecuteNonQuerye fecha a conexão.The example then calls ExecuteNonQuery, and closes the connection. Para fazer isso, a ExecuteNonQuery é passada 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 objeto OdbcConnection 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 objeto OdbcConnection 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 objeto OdbcConnection 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 qualquer objeto OdbcConnection aberto chamando Close ou Dispose antes que o objeto OdbcConnection saia do escopo ou colocando a conexão dentro de uma instrução Using.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 enfrentar erros relacionados ao Maximum Connections 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 métodos de Execute da classe OdbcCommand causar uma OdbcException fatal (por exemplo, um nível de severidade de SQL Server de 20 ou superior), o OdbcConnection poderá 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 objeto OdbcConnection 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. OdbcConnection cria demandas de segurança usando o objeto OdbcPermission.OdbcConnection creates security demands by using the OdbcPermission object. Os usuários podem verificar se o código tem permissões suficientes usando o objeto OdbcPermissionAttribute.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()

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

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

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

(Herdado de Component)
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

Obtém ou define o tempo de espera (em segundos) 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 (in seconds) while trying to establish a connection before terminating the attempt and generating an error.

Container

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

(Herdado de Component)
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

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

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.

(Herdado de Component)
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

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.

(Herdado de Component)
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

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

(Herdado de Component)
State

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

Métodos

BeginTransaction()

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

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)

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

Close()

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

CreateCommand()

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

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.

(Herdado de MarshalByRefObject)
Dispose()

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

(Herdado de Component)
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.

(Herdado de Component)
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)

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

Equals(Object)

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

(Herdado de Object)
GetHashCode()

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

(Herdado de Object)
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.

(Herdado de MarshalByRefObject)
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)

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[])

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)

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.

(Herdado de Component)
GetType()

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

(Herdado de Object)
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.

(Herdado de MarshalByRefObject)
MemberwiseClone()

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

(Herdado de Object)
MemberwiseClone(Boolean)

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

(Herdado de MarshalByRefObject)
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()

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()

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.

(Herdado de Component)

Eventos

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.

(Herdado de Component)
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

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

Implantações explícitas de interface

ICloneable.Clone()

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

IDbConnection.BeginTransaction()

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

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()

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