Share via

Propriedade CommandText (ADO)

  • Artigo

Indica o texto de um comando a ser emitido em um provedor.

Configurações e valores retornados

Obtém ou define um valor String que contém um comando de provedor, como uma instrução SQL, um nome de tabela, uma URL relativa ou uma chamada de procedimento armazenado. O padrão é a cadeia de caracteres vazia ("").

Comentários

Use a propriedade CommandText para definir ou retornar o texto de um comando representado por um objeto Command. Normalmente será uma instrução SQL, mas também pode ser qualquer outro tipo de instrução de comando reconhecida pelo provedor, como uma chamada de procedimento armazenado. Uma instrução SQL deve ser do dialeto específico ou da versão com suporte do processador de consulta do provedor.

Se a propriedade Prepared do objeto Command estiver definida como True e o objeto Command estiver associado a uma conexão aberta ao definir a propriedade CommandText, o ADO preparará a consulta (ou seja, uma forma compilada da consulta armazenada pelo provedor) quando você chamar os métodos Execute ou Open.

Dependendo da configuração da propriedade CommandType, o ADO pode alterar a propriedade CommandText. A propriedade CommandText pode ser lida a qualquer momento para ver o texto de comando real que o ADO usará durante a execução.

Use a propriedade CommandText para definir ou retornar uma URL relativa que especifica um recurso, como um arquivo ou diretório. O recurso é relativo a um local especificado explicitamente por uma URL absoluta ou implicitamente por um objeto Connection aberto.

Observação

As URLs que usam o esquema HTTP invocarão automaticamente o Provedor Microsoft OLE DB para Publicação na Internet. Para obter mais informações, confira URLs absolutas e relativas.

Aplica-se A

Objeto Command (ADO)

Consulte Também

Exemplo das propriedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (VB)
Exemplo das propriedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (VC++)
Método Requery
Exemplo das propriedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (JScript)