RelationalDatabaseFacadeExtensions.ExecuteSqlRawAsync Método

Definición

Espacio de nombres:

Microsoft.EntityFrameworkCore

Ensamblado:

Microsoft.EntityFrameworkCore.Relational.dll

Paquete:

Microsoft.EntityFrameworkCore.Relational v8.0.0

Sobrecargas

ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken)	Ejecuta el sql especificado en la base de datos y devuelve el número de filas afectadas.
ExecuteSqlRawAsync(DatabaseFacade, String, Object[])	Ejecuta el sql especificado en la base de datos y devuelve el número de filas afectadas.
ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken)	Ejecuta el sql especificado en la base de datos y devuelve el número de filas afectadas.

ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken)

Ejecuta el sql especificado en la base de datos y devuelve el número de filas afectadas.

public static System.Threading.Tasks.Task<int> ExecuteSqlRawAsync (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Collections.Generic.IEnumerable<object> parameters, System.Threading.CancellationToken cancellationToken = default);

static member ExecuteSqlRawAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

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

Parámetros

databaseFacade

DatabaseFacade

DatabaseFacade para el contexto.

sql

String

SQL que se va a ejecutar.

parameters

IEnumerable<Object>

Parámetros que se usarán con SQL.

cancellationToken

CancellationToken

Que CancellationToken se debe observar mientras se espera a que se complete la tarea.

Devoluciones

Task<Int32>

Tarea que representa la operación asincrónica. El resultado de la tarea es el número de filas afectadas.

Excepciones

OperationCanceledException

Si se cancela CancellationToken.

Comentarios

Tenga en cuenta que este método no inicia una transacción. Para usar este método con una transacción, llame primero a BeginTransaction(DatabaseFacade, IsolationLevel) o UseTransaction.

Tenga en cuenta que este método no usa el actual ExecutionStrategy , ya que es posible que SQL no sea idempotente y no se ejecute en una transacción. ExecutionStrategy se puede usar explícitamente, asegurándose de usar también una transacción si SQL no es idempotente.

Al igual que con cualquier API que acepte SQL, es importante parametrizar cualquier entrada de usuario para protegerse frente a un ataque por inyección de CÓDIGO SQL. Puede incluir marcadores de posición de parámetros en la cadena de consulta SQL y, a continuación, proporcionar valores de parámetro como argumentos adicionales. Los valores de parámetro que proporcione se convertirán automáticamente en un DbParameter.

Sin embargo, nunca se pasa una cadena concatenada o interpolada ($"") con valores proporcionados por el usuario no validados en este método. Si lo hace, puede exponer la aplicación a ataques por inyección de código SQL. Para usar la sintaxis de cadena interpolada, considere la posibilidad de usar ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken) para crear parámetros.

Consulte Ejecución de comandos SQL sin procesar con EF Core para obtener más información y ejemplos.

ExecuteSqlRawAsync(DatabaseFacade, String, Object[])

Ejecuta el sql especificado en la base de datos y devuelve el número de filas afectadas.

public static System.Threading.Tasks.Task<int> ExecuteSqlRawAsync (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object[] parameters);

static member ExecuteSqlRawAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * obj[] -> System.Threading.Tasks.Task<int>

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

Parámetros

databaseFacade

DatabaseFacade

DatabaseFacade para el contexto.

sql

String

SQL que se va a ejecutar.

parameters

Object[]

Parámetros que se usarán con SQL.

Devoluciones

Task<Int32>

Tarea que representa la operación asincrónica. El resultado de la tarea es el número de filas afectadas.

Comentarios

Tenga en cuenta que este método no inicia una transacción. Para usar este método con una transacción, llame primero a BeginTransaction(DatabaseFacade, IsolationLevel) o UseTransaction.

Tenga en cuenta que este método no usa el actual ExecutionStrategy , ya que es posible que SQL no sea idempotente y no se ejecute en una transacción. Se ExecutionStrategy puede usar explícitamente, asegurándose de usar también una transacción si SQL no es idempotente.

Al igual que con cualquier API que acepte SQL, es importante parametrizar cualquier entrada de usuario para protegerse frente a un ataque por inyección de CÓDIGO SQL. Puede incluir marcadores de posición de parámetros en la cadena de consulta SQL y, a continuación, proporcionar valores de parámetro como argumentos adicionales. Los valores de parámetro que proporcione se convertirán automáticamente en un DbParameter.

Sin embargo, nunca se pasa una cadena concatenada o interpolada ($"") con valores proporcionados por el usuario no validados en este método. Si lo hace, puede exponer la aplicación a ataques por inyección de código SQL. Para usar la sintaxis de cadena interpolada, considere la posibilidad de usar ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken) para crear parámetros.

Consulte Ejecución de comandos SQL sin procesar con EF Core para obtener más información y ejemplos.

ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken)

Ejecuta el sql especificado en la base de datos y devuelve el número de filas afectadas.

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

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

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

Parámetros

databaseFacade

DatabaseFacade

DatabaseFacade para el contexto.

sql

String

SQL que se va a ejecutar.

cancellationToken

CancellationToken

Que CancellationToken se debe observar mientras se espera a que se complete la tarea.

Devoluciones

Task<Int32>

Tarea que representa la operación asincrónica. El resultado de la tarea es el número de filas afectadas.

Excepciones

OperationCanceledException

Si se cancela CancellationToken.

Comentarios

Tenga en cuenta que este método no inicia una transacción. Para usar este método con una transacción, llame primero a BeginTransaction(DatabaseFacade, IsolationLevel) o UseTransaction.

Tenga en cuenta que este método no usa el actual ExecutionStrategy , ya que es posible que SQL no sea idempotente y no se ejecute en una transacción. Se ExecutionStrategy puede usar explícitamente, asegurándose de usar también una transacción si SQL no es idempotente.

Nunca pase una cadena concatenada o interpolada ($"") con valores proporcionados por el usuario no validados en este método. Si lo hace, puede exponer la aplicación a ataques por inyección de código SQL.

Consulte Ejecución de comandos SQL sin procesar con EF Core para obtener más información y ejemplos.