RelationalDatabaseFacadeExtensions.ExecuteSqlCommandAsync 메서드

정의

네임스페이스:

Microsoft.EntityFrameworkCore

어셈블리:

Microsoft.EntityFrameworkCore.Relational.dll

패키지:

Microsoft.EntityFrameworkCore.Relational v3.1.0

오버로드

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken)	사용되지 않음. 데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다. 이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 또는 를 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 합니다 UseTransaction(DatabaseFacade, DbTransaction). SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. ExecutionStrategy를 명시적으로 사용할 수 있으므로 SQL이 idempotent가 아닌 경우에도 트랜잭션을 사용해야 합니다. SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter로 변환됩니다. ExecuteSqlInterpolated를 사용하여 보간된 문자열 구문을 사용하여 매개 변수를 만드는 것도 고려할 수 있습니다.
ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken)	사용되지 않음. 데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다. 이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 또는 를 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 합니다 UseTransaction(DatabaseFacade, DbTransaction). SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. ExecutionStrategy를 명시적으로 사용할 수 있으므로 SQL이 idempotent가 아닌 경우에도 트랜잭션을 사용해야 합니다. SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)로 변환됩니다.
ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[])	사용되지 않음. 데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다. 이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 또는 를 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 합니다 UseTransaction(DatabaseFacade, DbTransaction). SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. ExecutionStrategy를 명시적으로 사용할 수 있으므로 SQL이 idempotent가 아닌 경우에도 트랜잭션을 사용해야 합니다. SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)로 변환됩니다. ExecuteSqlInterpolated를 사용하여 보간된 문자열 구문을 사용하여 매개 변수를 만드는 것도 고려할 수 있습니다.
ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken)	사용되지 않음. 데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다. 이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 또는 를 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 합니다 UseTransaction(DatabaseFacade, DbTransaction). SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. ExecutionStrategy를 명시적으로 사용할 수 있으므로 SQL이 idempotent가 아닌 경우에도 트랜잭션을 사용해야 합니다. SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter - context.Database.ExecuteSqlCommandAsync($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")로 변환됩니다.

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken)

주의

For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.

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

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

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

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

[System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, System.Collections.Generic.IEnumerable<object> parameters, System.Threading.CancellationToken cancellationToken = default);

[<System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")>]
static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

<Extension()>
Public Function ExecuteSqlCommandAsync (databaseFacade As DatabaseFacade, sql As RawSqlString, parameters As IEnumerable(Of Object), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

매개 변수

databaseFacade

DatabaseFacade

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

sql

RawSqlString

실행할 SQL입니다.

parameters

IEnumerable<Object>

SQL과 함께 사용할 매개 변수입니다.

cancellationToken

CancellationToken

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

반환

Task<Int32>

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

특성

ObsoleteAttribute

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken)

주의

For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.

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

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

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

SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)로 변환됩니다.

[System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, System.Threading.CancellationToken cancellationToken = default);

[<System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")>]
static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

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

매개 변수

databaseFacade

DatabaseFacade

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

sql

RawSqlString

실행할 SQL입니다.

cancellationToken

CancellationToken

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

반환

Task<Int32>

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

특성

ObsoleteAttribute

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[])

주의

For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.

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

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

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

SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 제공하는 모든 매개 변수 값은 DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)로 자동으로 변환됩니다. ExecuteSqlInterpolated를 사용하여 보간된 문자열 구문을 사용하여 매개 변수를 만드는 것도 고려할 수 있습니다.

[System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, params object[] parameters);

[<System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")>]
static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * obj[] -> System.Threading.Tasks.Task<int>

<Extension()>
Public Function ExecuteSqlCommandAsync (databaseFacade As DatabaseFacade, sql As RawSqlString, ParamArray parameters As Object()) As Task(Of Integer)

매개 변수

databaseFacade

DatabaseFacade

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

sql

RawSqlString

실행할 SQL입니다.

parameters

Object[]

SQL과 함께 사용할 매개 변수입니다.

반환

Task<Int32>

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

특성

ObsoleteAttribute

ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken)

주의

For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.

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

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

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

SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 제공하는 모든 매개 변수 값은 DbParameter - context.Database.ExecuteSqlCommandAsync($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")로 자동으로 변환됩니다.

[System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql, System.Threading.CancellationToken cancellationToken = default);

[<System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")>]
static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

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

매개 변수

databaseFacade

DatabaseFacade

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

sql

FormattableString

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

cancellationToken

CancellationToken

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

반환

Task<Int32>

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

특성

ObsoleteAttribute