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 ("").
Observações
Use a propriedade CommandText para definir ou retornar o texto de um comando representado por um objeto de Comando. 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 específico ou da versão compatível com o processador de consultas do provedor.
Se a propriedade Prepared do objeto Command estiver definida como True e o objeto de Comando estiver associado a uma conexão aberta quando você definir a propriedade CommandText, O ADO prepara a consulta (ou seja, uma forma compilada da consulta armazenada pelo provedor) quando você chama os métodos Executar ou Abrir.
Dependendo da configuração da propriedade CommandType, o ADO pode alterar a propriedade CommandText. Você pode ler a propriedade CommandText 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.
Nota
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, consulte URLs absolutas e relativas.
Aplica-se a
do objeto de comando (ADO)
Consulte Também
exemplo de propriedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (VB)
exemplo de propriedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (VC++)
método Requery
exemplo de propriedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (JScript)