Database.ExecuteSqlCommandAsync-Methode (TransactionalBehavior, String, CancellationToken, Object[])
[Diese Seite bezieht sich auf Entity Framework Version 6. Die neueste Version ist als 'Entity Framework' NuGet-Paket verfügbar. Weitere Informationen zu Entity Framework finden Sie unter msdn.com/data/ef.]
Führt asynchron den angegebenen DDL-/DML-Befehl für die Datenbank aus. Wie bei allen APIs, die SQL akzeptieren, müssen Sie darauf achten, alle Benutzereingaben zum Schutz vor SQL-Injection-Angriffen zu parametrisieren. Sie können in der SQL-Abfragezeichenfolge Platzhalter für Parameter einschließen und die Parameterwerte anschließend als zusätzliche Argumente angeben. Alle angegebenen Parameterwerte werden automatisch in einen DbParameter konvertiert. context.Database.ExecuteSqlCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor); Als Alternative können Sie auch einen DbParameter erstellen und an SqlQuery übergeben. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden. context.Database.ExecuteSqlCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor));
Namespace: System.Data.Entity
Assembly: EntityFramework (in EntityFramework.dll)
Syntax
'Declaration
Public Function ExecuteSqlCommandAsync ( _
transactionalBehavior As TransactionalBehavior, _
sql As String, _
cancellationToken As CancellationToken, _
ParamArray parameters As Object() _
) As Task(Of Integer)
'Usage
Dim instance As Database
Dim transactionalBehavior As TransactionalBehavior
Dim sql As String
Dim cancellationToken As CancellationToken
Dim parameters As Object()
Dim returnValue As Task(Of Integer)
returnValue = instance.ExecuteSqlCommandAsync(transactionalBehavior, _
sql, cancellationToken, parameters)
public Task<int> ExecuteSqlCommandAsync(
TransactionalBehavior transactionalBehavior,
string sql,
CancellationToken cancellationToken,
params Object[] parameters
)
public:
Task<int>^ ExecuteSqlCommandAsync(
TransactionalBehavior transactionalBehavior,
String^ sql,
CancellationToken cancellationToken,
... array<Object^>^ parameters
)
member ExecuteSqlCommandAsync :
transactionalBehavior:TransactionalBehavior *
sql:string *
cancellationToken:CancellationToken *
parameters:Object[] -> Task<int>
public function ExecuteSqlCommandAsync(
transactionalBehavior : TransactionalBehavior,
sql : String,
cancellationToken : CancellationToken,
... parameters : Object[]
) : Task<int>
Parameter
- transactionalBehavior
Typ: System.Data.Entity.TransactionalBehavior
Steuert die Erstellung einer Transaktion für diesen Befehl.
- sql
Typ: System.String
Die Befehlszeichenfolge.
- cancellationToken
Typ: System.Threading.CancellationToken
Ein CancellationToken, das beim Warten auf den Abschluss der Aufgabe überwacht werden soll.
- parameters
Typ: System.Object[]
Die Parameter, die auf die Befehlszeichenfolge angewendet werden sollen.
Rückgabewert
Typ: System.Threading.Tasks.Task<Int32>
Eine Aufgabe, die den asynchronen Vorgang darstellt.Das Aufgabeergebnis enthält das Ergebnis, das von der Datenbank zurückgegeben wurde, nachdem der Befehl ausgeführt wurde.
Hinweise
Mehrere aktive Vorgänge für dieselbe Kontextinstanz werden nicht unterstützt. Verwenden Sie await, um sicherzustellen, dass sämtliche asynchronen Vorgänge abgeschlossen sind, bevor eine andere Methode in diesem Kontext aufgerufen wird.