RelationalDatabaseFacadeExtensions.ExecuteSqlRaw 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| 속성 | Description |
|---|---|
| ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>) |
데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다. |
| ExecuteSqlRaw(DatabaseFacade, String, Object[]) |
데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다. |
ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)
데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다.
public static int ExecuteSqlRaw(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Collections.Generic.IEnumerable<object?> parameters);
public static int ExecuteSqlRaw(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Collections.Generic.IEnumerable<object> parameters);
static member ExecuteSqlRaw : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * seq<obj> -> int
<Extension()>
Public Function ExecuteSqlRaw (databaseFacade As DatabaseFacade, sql As String, parameters As IEnumerable(Of Object)) As Integer
매개 변수
- databaseFacade
- DatabaseFacade
컨텍스트의 경우입니다 DatabaseFacade .
- sql
- String
실행할 SQL입니다.
- parameters
- IEnumerable<Object>
SQL과 함께 사용할 매개 변수입니다.
반품
영향을 받는 행의 수입니다.
설명
이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 하거나 UseTransaction.
SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. ExecutionStrategy SQL이 idempotent가 아닌 경우 트랜잭션도 사용해야 하므로 명시적으로 사용할 수 있습니다.
SQL을 허용하는 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화해야 합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter로 변환됩니다.
그러나 유효성이 검사 되지 않은 사용자 제공 값이 있는 연결되거나 보간된 문자열($"")을 이 메서드에 전달하지 않습니다. 이렇게 하면 애플리케이션이 SQL 삽입 공격에 노출 될 수 있습니다. 보간된 문자열 구문을 사용하려면 매개 변수를 만드는 데 사용하는 ExecuteSql(DatabaseFacade, FormattableString) 것이 좋습니다.
자세한 내용 및 예제는 EF Core를 사용하여 원시 SQL 명령 실행을 참조하세요.
적용 대상
ExecuteSqlRaw(DatabaseFacade, String, Object[])
데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다.
public static int ExecuteSqlRaw(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object?[] parameters);
public static int ExecuteSqlRaw(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object[] parameters);
static member ExecuteSqlRaw : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * obj[] -> int
<Extension()>
Public Function ExecuteSqlRaw (databaseFacade As DatabaseFacade, sql As String, ParamArray parameters As Object()) As Integer
매개 변수
- databaseFacade
- DatabaseFacade
컨텍스트의 경우입니다 DatabaseFacade .
- sql
- String
실행할 SQL입니다.
- parameters
- Object[]
SQL과 함께 사용할 매개 변수입니다.
반품
영향을 받는 행의 수입니다.
설명
이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 하거나 UseTransaction.
SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. ExecutionStrategy SQL이 idempotent가 아닌 경우 트랜잭션도 사용해야 하므로 명시적으로 사용할 수 있습니다.
SQL을 허용하는 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화해야 합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter로 변환됩니다.
그러나 유효성이 검사 되지 않은 사용자 제공 값이 있는 연결되거나 보간된 문자열($"")을 이 메서드에 전달하지 않습니다. 이렇게 하면 애플리케이션이 SQL 삽입 공격에 노출 될 수 있습니다. 보간된 문자열 구문을 사용하려면 매개 변수를 만드는 데 사용하는 ExecuteSql(DatabaseFacade, FormattableString) 것이 좋습니다.
자세한 내용 및 예제는 EF Core를 사용하여 원시 SQL 명령 실행을 참조하세요.