RelationalDatabaseFacadeExtensions.ExecuteSqlAsync Yöntem

Tanım

Ad Alanı:

Microsoft.EntityFrameworkCore

Bütünleştirilmiş Kod:

Microsoft.EntityFrameworkCore.Relational.dll

Paket:

Microsoft.EntityFrameworkCore.Relational v10.0.0

Kaynak:

RelationalDatabaseFacadeExtensions.cs

Verilen SQL'i veritabanında yürütür ve etkilenen satır sayısını döndürür.

public static System.Threading.Tasks.Task<int> ExecuteSqlAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql, System.Threading.CancellationToken cancellationToken = default);

static member ExecuteSqlAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

<Extension()>
Public Function ExecuteSqlAsync (databaseFacade As DatabaseFacade, sql As FormattableString, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

Parametreler

databaseFacade

DatabaseFacade

DatabaseFacade bağlam için.

sql

FormattableString

Parametreleri olan bir SQL sorgusunu temsil eden ilişkilendirilmiş dize.

cancellationToken

CancellationToken

CancellationToken Görevin tamamlanmasını beklerken gözlemlemek için bir.

Döndürülenler

Task<Int32>

Zaman uyumsuz işlemi temsil eden bir görev. Görev sonucu, etkilenen satır sayısıdır.

Özel durumlar

OperationCanceledException

CancellationToken İptal edilirse.

Açıklamalar

Bu yöntemin bir işlem başlatmadığını unutmayın. Bu yöntemi bir işlemle kullanmak için, önce veya UseTransactionçağrısında bulunurBeginTransaction(DatabaseFacade, IsolationLevel).

SQL bir kez etkili olmadığından ve bir işlemde çalışmadığından, geçerlinin ExecutionStrategy bu yöntem tarafından kullanılmadığını unutmayın. açıkça ExecutionStrategy kullanılabilir ve SQL bir kez etkili değilse bir işlemi de kullandığınızdan emin olun.

SQL'i kabul eden herhangi bir API'de olduğu gibi, SQL ekleme saldırısına karşı koruma sağlamak için tüm kullanıcı girişlerini parametreleştirmek önemlidir. SQL sorgu dizesine parametre yer tutucuları ekleyebilir ve ardından parametre değerlerini ek bağımsız değişkenler olarak sağlayabilirsiniz. Sağladığınız tüm parametre değerleri otomatik olarak bir DbParameter'a dönüştürülür.

Daha fazla bilgi ve örnek için bkz. EF Core ile ham SQL komutlarını yürütme .