Objeto command (ADO)

  • Artigo

Aplica-se ao: Access 2013, Office 2013

Define um comando específico que você pretende executar em relação a uma fonte de dados.

Comentários

Use um objeto Command para consultar um banco de dados e retornar registros em um objeto Recordset, para executar uma operação em massa ou manipular a estrutura de um banco de dados. Dependendo da funcionalidade do provedor, alguns métodos e algumas coleções e propriedades Command poderão gerar um erro quando mencionados.

Com as coleções, os métodos e as propriedades de um objeto Command, você pode fazer o que segue:

  • Definir o texto executável do comando (por exemplo, uma instrução SQL) com a propriedade CommandText.

  • Definir consultas com parâmetros ou argumentos de procedimentos armazenados usando objetos Parameter e a coleção Parameters.

  • Executar um comando e retornar um objeto Recordset, se for adequado, com o método Execute.

  • Especificar o tipo de comando com a propriedade CommandType antes da execução para otimizar o desempenho.

  • Controlar se o provedor salvará uma versão preparada (ou compilada) do comando antes da execução com a propriedade Prepared.

  • Definir o número de segundos que um provedor aguardará um comando para executar a propriedade CommandTimeout.

  • Associar uma conexão aberta com um objeto Command definindo sua propriedade ActiveConnection.

  • Definir a propriedade Name para identificar o objeto Command como um método no objeto Connection associado.

  • Passar um objeto Command para a propriedade Source de um Recordset para obter dados.

  • Acessar os atributos específicos do provedor com a coleção Properties.

Observação

[!OBSERVAçãO] Para executar uma consulta sem usar um objeto Command, passe uma sequência de consulta para o método Execute de um objeto Connection ou para o método Open de um objeto Recordset. No entanto, um objeto Command será necessário quando você quiser insistircom o texto de comando e reexecutá-lo ou usar os parâmetros de consulta.

Para criar um objeto Command, de forma independente, de um objeto Connection definido anteriormente, defina a propriedade ActiveConnection como uma sequência de conexão válida. O ADO ainda criará um objeto Connection, mas não atribuirá esse objeto a uma variável de objeto. No entanto, se você estiver associando vários objetos Command com a mesma conexão, deverá criar e abrir, de forma explícita, um objeto Connection; isso atribui o objeto Connection a uma variável de objeto. Se você não definir a propriedade ActiveConnection do objeto Command para esta variável de objeto, o ADO criará um novo objeto Connection para cada objeto Command, mesmo se você usar a mesma sequência de conexão.

Para executar um objeto Command, basta chamá-lo por meio da propriedade Name do objeto Connection associado. Command deve ter a propriedade ActiveConnection definida como o objeto Connection. Se Command tiver parâmetros, passe seus valores como argumentos para o método.

Se dois ou mais objetos Command forem executados na mesma conexão e o objeto Command estiver em um procedimento armazenado com parâmetros de saída, ocorrerá um erro. Para executar cada objeto Command, use conexões separadas ou desconecte todos os outros objetos Command da conexão.

A coleção Parameters é o membro padrão do objeto Command. Como resultado, as duas instruções de código a seguir são equivalentes.