Objeto Command (ADO)
Define um comando específico que você pretende executar em uma fonte de dados.
Observações
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 coleções, métodos ou propriedades do Command podem gerar um erro quando forem referenciados.
Com as coleções, os métodos e as propriedades de um objeto de comando, você pode fazer o seguinte:
Defina o texto executável do comando (por exemplo, uma instrução SQL) com a propriedade CommandText. Como alternativa, para estruturas de comando ou consulta diferentes de cadeias de caracteres simples (por exemplo, consultas de modelo XML) defina o comando com a propriedade CommandStream.
Opcionalmente, indique o dialeto de comando usado no CommandText ou CommandStream com a propriedade Dialeto.
Defina consultas parametrizadas ou argumentos de procedimento armazenado com objetos Parameter e a coleção parâmetros.
Indique se os nomes de parâmetro devem ser passados para o provedor com a propriedade NamedParameters.
Execute um comando e retorne um objeto Recordset, se apropriado, com o método Execute.
Especifique o tipo de comando com a propriedade CommandType antes da execução para otimizar o desempenho.
Controlar se o provedor salva uma versão preparada (ou compilada) do comando antes da execução com a propriedade Prepared.
Defina o número de segundos que um provedor aguardará a execução de um comando com a propriedade CommandTimeout.
Associe uma conexão aberta a um objeto de comando definindo sua propriedade ActiveConnection.
Defina a propriedade Name para identificar o objeto Command como um método no objeto connection associado.
Passe um objeto de Comando para a propriedade Source de um Recordset para obter dados.
Acesse atributos específicos do provedor com a coleção Propriedades do.
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 ou para o método Open de um objeto Recordset. 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.
Para criar um objeto Command independentemente de um objeto Connection definido anteriormente, defina sua propriedade ActiveConnection como uma cadeia de conexão válida. O ADO ainda cria um objeto Connection, mas não atribui esse objeto a uma variável de objeto. No entanto, se você estiver associando vários objetos Command com a mesma conexão, você deverá criar e abrir explicitamente um objeto Connection; isso atribui o objeto Connection a uma variável de objeto. Verifique se o objeto Connection foi aberto com êxito antes de atribuí-lo à propriedade ActiveConnection do objeto command do, pois atribuir um objeto de Conexão fechado causa um erro. Se você não definir a propriedade ActiveConnection do objeto Command para essa variável de objeto, o ADO criará um novo objeto Connection para cada objeto command, mesmo se você usar a mesma cadeia de conexão.
Para executar um comando , chame-o por sua propriedade name no objeto Connection associado. O comando deve ter sua propriedade ActiveConnection definida como o objeto conexão. Se o comando 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 for 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 do Comando da conexão.
A coleção parâmetros é o membro padrão do objeto command. Como resultado, as duas instruções de código a seguir são equivalentes.
objCmd.Parameters.Item(0)
objCmd(0)
- O objeto comando não é seguro para scripts.
Esta seção contém o tópico a seguir.
Consulte Também
do objeto de conexão (ADO)
da Coleção de Parâmetros (ADO)
da coleção Properties (ADO)
apêndice A : provedores