RelationalDatabaseFacadeExtensions.ExecuteSqlAsync Metoda

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.Relational.dll

Balíček:

Microsoft.EntityFrameworkCore.Relational v8.0.0

Spustí daný jazyk SQL proti databázi a vrátí počet ovlivněných řádků.

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)

Parametry

databaseFacade

DatabaseFacade

Kontext DatabaseFacade .

sql

FormattableString

Interpolovaný řetězec představující dotaz SQL s parametry.

cancellationToken

CancellationToken

K CancellationToken pozorování při čekání na dokončení úlohy.

Návraty

Task<Int32>

Úloha, která představuje asynchronní operaci. Výsledek úkolu je počet ovlivněných řádků.

Výjimky

OperationCanceledException

CancellationToken Pokud je zrušena.

Poznámky

Všimněte si, že tato metoda nespustí transakci. Chcete-li použít tuto metodu s transakcí, nejprve zavolejte BeginTransaction(DatabaseFacade, IsolationLevel) nebo UseTransaction.

Všimněte si, že aktuální ExecutionStrategy není používán touto metodou, protože SQL nemusí být idempotentní a nespustí v transakci. Je ExecutionStrategy možné použít explicitně a nezapomeňte také použít transakci, pokud SQL není idempotentní.

Stejně jako u každého rozhraní API, které přijímá SQL, je důležité parametrizovat jakýkoli uživatelský vstup, aby se chránil před útokem prostřednictvím injektáže SQL. Do řetězce dotazu SQL můžete zahrnout držitelé míst parametrů a pak zadat hodnoty parametrů jako další argumenty. Všechny hodnoty parametrů, které zadáte, se automaticky převedou na DbParameter.

Další informace a příklady najdete v tématu Spouštění nezpracovaných příkazů SQL pomocí EF Core .