Proprietà CommandText (ADO)

  • Articolo

Indica il testo di un comando da eseguire su un provider.

Impostazioni e valori restituiti

Ottiene o imposta un valore String che contiene un comando del provider, ad esempio un'istruzione SQL, un nome di tabella, un URL relativo o una chiamata di stored procedure. Il valore predefinito è la stringa vuota ("").

Osservazioni

Utilizzare la proprietà CommandText per impostare o restituire il testo di un comando rappresentato da un oggetto Command. In genere si tratta di un'istruzione SQL, ma può anche essere qualsiasi altro tipo di istruzione di comando riconosciuto dal provider, ad esempio una chiamata di stored procedure. Un'istruzione SQL deve essere della versione o del dialetto particolare supportato dal processore di query del provider.

Se la proprietà Prepared dell’oggetto Command è impostata su True e l’oggetto Command è associato a una connessione aperta quando si imposta la proprietà CommandText, ADO prepara la query (ovvero un modulo compilato della query archiviata dal provider) quando si chiamano i metodi Execute o Open.

A seconda dell'impostazione della proprietà CommandType, ADO può modificare la proprietà CommandText. È possibile leggere la proprietà CommandText in qualsiasi momento per visualizzare il testo effettivo del comando che ADO userà durante l'esecuzione.

Utilizzare la proprietà CommandText per impostare o restituire un URL relativo che specifica una risorsa, ad esempio un file o una directory. La risorsa è relativa a una posizione specificata in modo esplicito da un URL assoluto o in modo implicito da un oggetto Connection aperto.

Nota

Gli URL che usano lo schema http richiamano automaticamente il provider Microsoft OLE DB per Internet Publishing. Per altre informazioni, vedere URL assoluti e relativi.

Si applica a

Oggetto Command (ADO)

Vedere anche

Esempio di proprietà ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (VB)
Esempio di proprietà ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (VC++)
Metodo Requery
Esempio di proprietà ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (JScript)