ObjectContext.ExecuteStoreCommandAsync, méthode (String, CancellationToken, Object[])
[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]
Exécute de façon asynchrone une commande arbitraire directement sur la source de données en utilisant la connexion existante. La commande est spécifiée à l'aide du langage de requête natif du serveur, par exemple SQL. Comme pour tout API qui accepte SQL, il est important de paramétrer toutes les entrées utilisateur afin de se prémunir contre une attaque d'injection SQL. Vous pouvez inclure des espaces de paramètre réservés dans la chaîne de requête SQL, puis fournir des valeurs de paramètre comme arguments supplémentaires. Toute valeur de paramètre fournie sera automatiquement convertie en un DbParameter. context.ExecuteStoreCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor). Sinon, construisez un DbParameter et fournissez-le à SqlQuery. Cela vous permet d'utiliser des paramètres nommés dans la chaîne de requête SQL. context.ExecuteStoreCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor)) ;
Espace de noms : System.Data.Entity.Core.Objects
Assembly : EntityFramework (dans EntityFramework.dll)
Syntaxe
'Déclaration
Public Overridable Function ExecuteStoreCommandAsync ( _
commandText As String, _
cancellationToken As CancellationToken, _
ParamArray parameters As Object() _
) As Task(Of Integer)
'Utilisation
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>
Paramètres
- commandText
Type : System.String
La commande est spécifiée à l'aide du langage de requête natif du serveur.
- cancellationToken
Type : System.Threading.CancellationToken
CancellationToken à observer en attendant que la tâche se termine.
- parameters
Type : System.Object[]
Valeurs de paramètre à utiliser pour la requête.
Valeur de retour
Type : System.Threading.Tasks.Task<Int32>
Tâche qui représente l'opération asynchrone.Le résultat de la tâche contient le nombre de lignes affectées.
Notes
Plusieurs opérations actives sur la même instance de contexte ne sont pas prises en charge. Utilisez « await » pour garantir que toutes les opérations asynchrones sont terminées avant d'appeler une autre méthode dans ce contexte. S'il n'existe pas de transaction locale, une nouvelle transaction sera utilisée pour exécuter la commande.