Metodo ObjectContext.ExecuteStoreCommandAsync (String, CancellationToken, Object[])
[Questa pagina è specifica della versione 6 di Entity Framework. La versione più recente è disponibile come pacchetto NuGet per "Entity Framework". Per ulteriori informazioni su Entity Framework, vedere la pagina msdn.com/data/ef.]
Esegue in modo asincrono un comando arbitrario direttamente sull'origine dati usando la connessione esistente. Il comando viene specificato usando il linguaggio di query nativo del server, ad esempio SQL. Come con qualsiasi API che accetta SQL, è importante parametrizzare un input utente in modo da fornire protezione da un attacco SQL injection. È possibile includere i segnaposto dei parametri nella stringa di query SQL e quindi fornire i valori dei parametri come argomenti aggiuntivi. Tutti i valori dei parametri forniti verranno convertiti automaticamente in DbParameter. context.ExecuteStoreCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor); in alternativa, è inoltre possibile costruire un oggetto DbParameter e fornirlo a SqlQuery. In questo modo è possibile usare i parametri denominati nella stringa di query SQL. context.ExecuteStoreCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor));
Spazio dei nomi: System.Data.Entity.Core.Objects
Assembly: EntityFramework (in EntityFramework.dll)
Sintassi
'Dichiarazione
Public Overridable Function ExecuteStoreCommandAsync ( _
commandText As String, _
cancellationToken As CancellationToken, _
ParamArray parameters As Object() _
) As Task(Of Integer)
'Utilizzo
Dim instance As ObjectContext
Dim commandText As String
Dim cancellationToken As CancellationToken
Dim parameters As Object()
Dim returnValue As Task(Of Integer)
returnValue = instance.ExecuteStoreCommandAsync(commandText, _
cancellationToken, parameters)
public virtual Task<int> ExecuteStoreCommandAsync(
string commandText,
CancellationToken cancellationToken,
params Object[] parameters
)
public:
virtual Task<int>^ ExecuteStoreCommandAsync(
String^ commandText,
CancellationToken cancellationToken,
... array<Object^>^ parameters
)
abstract ExecuteStoreCommandAsync :
commandText:string *
cancellationToken:CancellationToken *
parameters:Object[] -> Task<int>
override ExecuteStoreCommandAsync :
commandText:string *
cancellationToken:CancellationToken *
parameters:Object[] -> Task<int>
public function ExecuteStoreCommandAsync(
commandText : String,
cancellationToken : CancellationToken,
... parameters : Object[]
) : Task<int>
Parametri
- commandText
Tipo: System.String
Comando specificato nel linguaggio di query nativo del server.
- cancellationToken
Tipo: System.Threading.CancellationToken
Oggetto CancellationToken da osservare durante l'attesa del completamento dell'attività.
- parameters
Tipo: System.Object[]
Valori dei parametri da usare per la query.
Valore restituito
Tipo: System.Threading.Tasks.Task<Int32>
Attività che rappresenta l'operazione asincrona.Il risultato dell'attività contiene il numero di righe interessate.
Note
Non è consentito eseguire più operazioni attive nella stessa istanza di contesto. Usare 'await' per assicurarsi che eventuali operazioni asincrone vengano completate prima di chiamare un altro metodo su questo contesto. Se non è presente una transazione locale verrà usata una nuova transazione per eseguire il comando.