Metodo Execute (Connection - ADO)

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

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, stored procedure, un URL o un testo specifico del provider da eseguire. Facoltativamente, è possibile usare i nomi di tabella, ma solo se il provider SQL in grado di riconoscere. Ad esempio, se viene usato un nome di tabella "Customers", ADO anteporrà automaticamente la sintassi SQL Select standard per formare e passerà "SELECT * FROM Customers" come istruzione al Transact-SQL provider.

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

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

Nota Usare il valore ExecuteOptionEnum adExecuteNoRecords per migliorare le prestazioni riducendo al minimo l'elaborazione interna e per le applicazioni da convertire 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 Method (ADO Recordset) e Requery Method di un recordset.

Commenti

L'uso del metodo Execute in un oggetto ADO (Connection Object) esegue qualsiasi query passata al metodo nell'argomento CommandText nella connessione specificata. Se l'argomento CommandText specifica una query che restituisce righe, tutti i risultati generati dall'esecuzione vengono archiviati in un nuovo oggetto Recordset. 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.

L'oggetto Recordset restituito è sempre un cursore forward-only di sola lettura. Se è necessario un oggetto Recordset con più funzionalità, creare prima un oggetto Recordset con le impostazioni delle proprietà desiderate, quindi usare il metodo Open Method (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 SQL sintassi 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 microsoft OLE DB Provider for Internet Publishing. Per altre informazioni, vedere URL assoluti e relativi.

Si applica a

Oggetto Connection (ADO)