Partilhar via


Propriedade CommandText (ADO)

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, essa 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 ou versão específica com suporte do processador de consultas 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)

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