다음을 통해 공유


RelationalDatabaseFacadeExtensions.ExecuteSqlAsync 메서드

정의

데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다.

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)

매개 변수

databaseFacade
DatabaseFacade

DatabaseFacade 컨텍스트에 대한 입니다.

sql
FormattableString

매개 변수가 있는 SQL 쿼리를 나타내는 보간된 문자열입니다.

cancellationToken
CancellationToken

CancellationToken 작업이 완료 될 때까지 기다리는 동안 관찰할 입니다.

반환

비동기 작업(operation)을 나타내는 작업(task)입니다. 작업 결과는 영향을 받는 행의 수입니다.

예외

설명

이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 또는 를 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 합니다 UseTransaction.

SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. 를 ExecutionStrategy 명시적으로 사용할 수 있으며 SQL이 idempotent가 아닌 경우에도 트랜잭션을 사용해야 합니다.

SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter로 변환됩니다.

자세한 내용 과 예제는 EF Core를 사용하여 원시 SQL 명령 실행을 참조하세요.

적용 대상