Propriedade CommandText (ADO)

Aplica-se ao: Access 2013, Office 2013

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

Configurações e valores retornados

Define ou retorna um valor String contendo 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 é "" (sequência de comprimento zero).

Comentários

Use a propriedade CommandText para definir ou retornar o texto de um comando representado por um objeto Command. Geralmente, é 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 de um dialeto ou versão específica que tenha suporte do processador de consultas do provedor.

Se a propriedade Prepared do objeto Command estiver definida como True e o objeto Command estiver vinculado a uma conexão aberta quando você definir a propriedade CommandText, o ADO preparará a consulta (isto é, um formulário compilado da consulta que é armazenado pelo provedor) quando você chamar os métodos Execute ou Open.

Dependendo da definição da propriedade CommandType, o ADO poderá alterar a propriedade CommandText. Você pode ler a propriedade CommandText a qualquer momento para ver o texto de comando real que será utilizado pelo ADO durante a execução.

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

Observação

[!OBSERVAçãO] URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. Para obter mais informações, consulte URLs absolutas e relativas.