RelationalDatabaseFacadeExtensions.ExecuteSqlRaw 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.Relational.dll

包:

Microsoft.EntityFrameworkCore.Relational v8.0.0

重载

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);

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 一起使用的参数。

返回

Int32

受影响的行数。

注解

请注意，此方法不会启动事务。 若要将此方法用于事务，请先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction。

请注意，此方法不使用当前 ExecutionStrategy ，因为 SQL 可能不是幂等的，也不会在事务中运行。 ExecutionStrategy可以显式使用 ，如果 SQL 不是幂等的，请确保也使用事务。

与任何接受 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);

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 一起使用的参数。

返回

Int32

受影响的行数。

注解

请注意，此方法不会启动事务。 若要将此方法用于事务，请先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction。

请注意，此方法不使用当前 ExecutionStrategy ，因为 SQL 可能不是幂等的，也不会在事务中运行。 ExecutionStrategy可以显式使用 ，如果 SQL 不是幂等的，请确保也使用事务。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。

但是， 切勿 将串联或内插字符串 ($"") 与未经验证的用户提供的值传递到此方法中。 这样做可能会使应用程序受到 SQL 注入攻击。 若要使用内插字符串语法，请考虑使用 ExecuteSql(DatabaseFacade, FormattableString) 创建参数。

有关详细信息和示例 ，请参阅使用 EF Core 执行原始 SQL 命令 。