Metodo Execute (comando ADO)
Esegue la query, l'istruzione SQL o la stored procedure specificata nella proprietà CommandText o CommandStream dell'oggetto Command .
Sintassi
Set recordset = command.Execute( RecordsAffected, Parameters, Options )
Valore restituito
Restituisce un riferimento oggetto Recordset, un flusso o Nothing.
Parametri
RecordsAffected
Opzionale. Variabile long a cui il provider restituisce il numero di record interessati dall'operazione. Il parametro RecordAffected si applica solo per le query di azione o le stored procedure.
RecordAffected non restituisce il numero di record restituiti da una query o una stored procedure che restituisce risultati. Per ottenere queste informazioni, utilizzare la proprietà RecordCount. Il metodo Execute non restituisce le informazioni corrette quando viene 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
Opzionale. Matrice di parametri Variant utilizzata 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
Opzionale. Valore long che indica come il provider deve valutare l'CommandText o la proprietà CommandStream dell'oggetto Command. Può essere un valore di maschera di bit creato usando valori CommandTypeEnum e/o ExecuteOptionEnum. Ad esempio, è possibile usare adCmdText e adExecuteNoRecords in combinazione se si desidera 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 utilizzare i valori di 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 .
Osservazioni
L'utilizzo del metodo Execute su un oggetto Command esegue la query specificata nella proprietà CommandText o proprietà CommandStream dell'oggetto .
I risultati vengono restituiti in un recordset (per impostazione predefinita) o come flusso di informazioni binarie. Per ottenere un flusso binario, specificare adExecuteStream in Opzioni, quindi specificare un flusso impostando Command.Properties("Output Stream"). È possibile specificare un oggetto ADO Stream per ricevere i risultati oppure è possibile specificare un altro oggetto flusso, ad esempio l'oggetto IIS Response. Se non è stato specificato alcun flusso prima di chiamare Esegui con adExecuteStream, si verifica un errore. La posizione del flusso restituito da Execute è specifica del provider.
Se il comando non ha lo scopo di restituire risultati(ad esempio, una query SQL UPDATE), il provider restituisce Nothing purché venga 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 recordset.
Execute genera un errore se l'utente specifica un valore per CommandStream quando l'CommandType è adCmdStoredProc, adCmdTableo adCmdTableDirect.
Se la query include parametri, vengono usati i valori correnti per i parametri dell'oggetto command, a meno che non si esegua l'override di questi valori con i valori dei parametri passati con la chiamata Execute. È possibile eseguire l'override di un subset dei parametri omettendo nuovi valori per alcuni dei parametri quando si chiama il metodo Execute . L'ordine in cui si specificano i parametri è lo stesso ordine in cui il metodo li passa. Ad esempio, se sono presenti quattro o più parametri e si desidera passare nuovi valori solo per i primi e i quarto parametri, si passerebbe Array(var1,,,var4) come argomento Parameters.
Nota
I parametri di output non restituiscono valori corretti quando vengono passati nell'argomento parametri di.
Al termine dell'operazione verrà generato un evento ExecuteComplete.
Nota
Quando si emettono comandi contenenti URL, gli utenti 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
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
Execute (connessione ADO)
'evento ExecuteComplete (ADO)