Metodo Execute (Command - ADO)

Esegue la query, SQL istruzione o stored procedure specificata nella proprietà CommandText o CommandStream dell'oggetto Command.

Sintassi

  
Set recordset = command.Execute( RecordsAffected, Parameters, Options )  

Valore restituito

Restituisce un riferimento a un oggetto Recordset, un flusso o Nothing.

Parametri

RecordsAffected
facoltativo. Variabile Long a cui il provider restituisce il numero di record interessati dall'operazione. Il parametro RecordsAffected si applica solo alle query di azione o alle stored procedure. RecordsAffected non restituisce il numero di record restituiti da una query o da un stored procedure. Per ottenere queste informazioni, usare la proprietà RecordCount. Il metodo Execute non restituirà le informazioni corrette se usato con adAsyncExecute, semplicemente perché quando un comando viene eseguito in modo asincrono, il numero di record interessati potrebbe non essere ancora noto al momento della restituzione del metodo.

Parametri
facoltativo. Matrice Variant di valori di parametro utilizzati insieme alla stringa di input o al flusso specificato in CommandText o CommandStream. I parametri di output non restituiscono valori corretti quando vengono passati in questo argomento.

Opzioni
facoltativo. Valore Long che indica come il provider deve valutare la proprietà CommandText o CommandStream dell'oggetto Command. Può essere un valore di maschera di bit creato usando i valori CommandTypeEnum e/o ExecuteOptionEnum. Ad esempio, è possibile usare adCmdText e adExecuteNoRecords in combinazione se si vuole fare in modo che ADO valuti il valore della proprietà CommandText come testo e indichi che il comando deve eliminare e non restituire record che potrebbero essere generati quando viene eseguito il testo del comando.

Nota

Usare il valore ExecuteOptionEnum adExecuteNoRecords per migliorare le prestazioni riducendo al minimo l'elaborazione interna. Se è stato specificato adExecuteStream, le opzioni adAsyncFetch e adAsynchFetchNonBlocking vengono ignorate. Non usare i valori CommandTypeEnum di adCmdFile o adCmdTableDirect con Execute. Questi valori possono essere usati solo come opzioni con i metodi Open e Requery di un oggetto Recordset.

Commenti

L'uso del metodo Execute in un oggetto Command esegue la query specificata nella proprietà CommandText o Nella proprietà CommandStream dell'oggetto.

I risultati vengono restituiti in un oggetto Recordset (per impostazione predefinita) o come flusso di informazioni binarie. Per ottenere un flusso binario, specificare adExecuteStream in Opzioni, quindi fornire un flusso impostando Command.Properties("Output Stream"). È possibile specificare un oggetto Flusso ADO per ricevere i risultati oppure un altro oggetto flusso, ad esempio l'oggetto Risposta IIS. Se non è stato specificato alcun flusso prima di chiamare Execute con adExecuteStream, si verifica un errore. La posizione del flusso al ritorno da Execute è specifica del provider.

Se il comando non è destinato a restituire risultati ,ad esempio una query update SQL), il provider restituisce Nothing purché sia specificata l'opzione adExecuteNoRecords. In caso contrario, Execute restituisce un oggetto Recordset chiuso. Alcuni linguaggi dell'applicazione consentono di ignorare questo valore restituito se non si desidera alcun oggetto Recordset.

Execute genera un errore se l'utente specifica un valore per CommandStream quando CommandType è adCmdStoredProc, adCmdTable o adCmdTableDirect.

Se la query include parametri, vengono usati i valori correnti per i parametri dell'oggetto Command, a meno che non vengano eseguiti l'override con i valori dei parametri passati con la chiamata Execute. È possibile eseguire l'override di un subset dei parametri omettendo nuovi valori per alcuni parametri quando si chiama il metodo Execute. L'ordine in cui si specificano i parametri è lo stesso in cui il metodo li passa. Ad esempio, se sono presenti quattro (o più) parametri e si desidera passare nuovi valori solo per il primo e il quarto parametro, si passerebbe come Array(var1,,,var4) argomento Parameters.

Nota

I parametri di output non restituiscono valori corretti quando vengono passati nell'argomento Parameters.

Al termine dell'operazione verrà generato un evento ExecuteComplete.

Nota

Quando si emette comandi contenenti URL, gli utenti che usano lo schema HTTP richiamano automaticamente Microsoft OLE DB Provider per la pubblicazione Internet. Per altre informazioni, vedere URL assoluti e relativi.

Si applica a

Oggetto Command (ADO)

Vedere anche

Esempio di metodi Execute, Requery e Clear (VB)
Esempio di metodi Execute, Requery e Clear (VBScript)
Esempio di metodi Execute, Requery e Clear (VC++)
Proprietà CommandStream (ADO)
Proprietà CommandText (ADO)
Commandtypeenum
Metodo Execute (connessione ADO)
Evento ExecuteComplete (ADO)