Metodo Execute (Connection - ADO)

Esegue la query, l'istruzione SQL, la stored procedure o il testo specifico del provider specificati.

Sintassi

  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  

Valore restituito

Restituisce un riferimento all'oggetto Recordset (ADO).

Parametri

CommandText
Valore String che contiene l'istruzione SQL, la stored procedure, un URL o un testo specifico del provider da eseguire. Facoltativamente, è possibile usare i nomi di tabella, ma solo se il provider supporta SQL. Ad esempio, se viene usato un nome di tabella "Clienti", ADO antepone automaticamente la sintassi SQL Select standard per formare e passare "SELECT * FROM Customers" come istruzione Transact-SQL al provider.

RecordsAffected
facoltativo. Una variabile Long a cui il provider restituisce il numero di record interessati dall'operazione.

Opzioni
facoltativo. Valore Long che indica in che modo il provider deve valutare l'argomento CommandText. Può essere una maschera bit di uno o più valori CommandTypeEnum o ExecuteOptionEnum.

Nota Usare il valore ExecuteOptionEnumadExecuteNoRecords per migliorare le prestazioni riducendo al minimo l'elaborazione interna e per le applicazioni di cui si esegue il trasferimento da Visual Basic 6.0.

Non usare adExecuteStream con il metodo Execute di un oggetto Connection.

Non usare i valori CommandTypeEnum di adCmdFile o adCmdTableDirect con Execute. Questi valori possono essere usati solo come opzioni con i metodi Open (ADO Recordset) e Requery di un Recordset.

Osservazioni

L'uso del metodo Execute su un oggetto Connection Object (ADO) esegue qualsiasi query passata al metodo nell'argomento CommandText nella connessione specificata. Se l'argomento CommandText specifica una query di restituzione delle righe, tutti i risultati generati dall'esecuzione vengono archiviati in un nuovo oggetto Recordset. Se il comando non deve restituire risultati (ad esempio, una query UPDATE di SQL) il provider restituisce Nothing a condizione che venga specificata l'opzione adExecuteNoRecords; in caso contrario, Execute restituisce un Recordset chiuso.

L'oggetto Recordset restituito è sempre un cursore forward-only di sola lettura. Se è necessario un oggetto Recordset con maggiore funzionalità, creare prima un oggetto Recordset con le impostazioni delle proprietà desiderate, quindi usare il metodo Open (ADO Recordset) dell'oggetto Recordset per eseguire la query e restituire il tipo di cursore desiderato.

Il contenuto dell'argomento CommandText è specifico del provider e può essere sintassi SQL standard o qualsiasi formato di comando speciale supportato dal provider.

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

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 Connection (ADO)