Objeto Connection (ADO)
Representa uma conexão aberta com uma fonte de dados.
Observações
Um objeto Connection representa uma sessão exclusiva com uma fonte de dados. Em um sistema de banco de dados cliente/servidor, ele pode ser equivalente a uma conexão de rede real com o servidor. Dependendo da funcionalidade com suporte do provedor, algumas coleções, métodos ou propriedades de um objeto Connection podem não estar disponíveis.
Com as coleções, métodos e propriedades de um objeto Connection, você pode fazer o seguinte:
Configure a conexão antes de abri-la com as propriedades ConnectionString, ConnectionTimeoute Mode. ConnectionString é a propriedade padrão do objeto Connection.
Defina a propriedade CursorLocation como cliente para invocar o Microsoft Cursor Service for OLE DB, que dá suporte a atualizações em lote.
Defina o banco de dados padrão para a conexão com a propriedade DefaultDatabase.
Defina o nível de isolamento para as transações abertas na conexão com a propriedade IsolationLevel.
Especifique um provedor OLE DB com a propriedade provedor de.
Estabeleça e, posteriormente, a conexão física com a fonte de dados com os métodos Open e Close.
Execute um comando na conexão com o método Execute e configure a execução com a propriedade CommandTimeout.
Nota
Para executar uma consulta sem usar um objeto Command, passe uma cadeia de caracteres de consulta para o método Execute de um objeto Connection. No entanto, um objeto Command é necessário quando você deseja persistir o texto do comando e executá-lo novamente ou usar parâmetros de consulta.
Gerencie transações na conexão aberta, incluindo transações aninhadas se o provedor der suporte a elas, com os métodos BeginTrans, CommitTranse métodos RollbackTrans e a propriedade Attributes.
Examine os erros retornados da fonte de dados com a coleção Errors.
Leia a versão da implementação do ADO usada com a propriedade Version.
Obtenha informações de esquema sobre seu banco de dados com o método OpenSchema.
Você pode criar objetos Connection independentemente de qualquer outro objeto definido anteriormente.
Você pode executar comandos nomeados ou procedimentos armazenados como se fossem métodos nativos em um objeto Connection, conforme mostrado na próxima seção. Quando um comando nomeado tiver o mesmo nome de um procedimento armazenado, invoque a "chamada de método nativo" em um objeto Connection sempre execute o comando nomeado em vez do procedimento de repositório.
Nota
Não use esse recurso (chamando um comando nomeado ou procedimento armazenado como se fosse um método nativo no objeto Connection) em um aplicativo do Microsoft .NET Framework, pois a implementação subjacente do recurso está em conflito com a maneira como o .NET Framework interopera com COM.
Executar um comando como um método nativo de um objeto Connection
Para executar um comando, dê um nome ao comando usando o objeto CommandName propriedade. Defina a propriedade ActiveConnection do objeto de comando para a conexão. Em seguida, emita uma instrução em que o nome do comando é usado como se fosse um método no objeto Connection, seguido por quaisquer parâmetros e um objeto Recordset se alguma linha for retornada. Defina as propriedades do conjunto de registros para personalizar o de conjunto de registrosresultante. Por exemplo:
Dim cnn As New ADODB.Connection
Dim cmd As New ADODB.Command
Dim rst As New ADODB.Recordset
...
cnn.Open "..."
cmd.Name = "yourCommandName"
cmd.ActiveConnection = cnn
...
'Your command name, any parameters, and an optional Recordset.
cnn. "parameter", rst
Executar um procedimento armazenado como um método nativo de um objeto Connection
Para executar um procedimento armazenado, emita uma instrução em que o nome do procedimento armazenado é usado como se fosse um método no objeto Connection, seguido por quaisquer parâmetros. O ADO fará um "melhor palpite" dos tipos de parâmetro. Por exemplo:
Dim cnn As New ADODB.Connection
...
'Your stored procedure name and any parameters.
cnn. "parameter"
O objeto Connection é seguro para scripts.
Esta seção contém o tópico a seguir.
Consulte Também
do objeto de comando (ADO)
coleção de erros (ADO)
da coleção Properties (ADO)
do objeto Recordset (ADO)
apêndice A : provedores