RelationalDatabaseFacadeExtensions 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
返回的DatabaseFacade扩展方法Database只能与关系数据库提供程序一起使用。
public static class RelationalDatabaseFacadeExtensions[System.Runtime.CompilerServices.Nullable(0)]
public static class RelationalDatabaseFacadeExtensionstype RelationalDatabaseFacadeExtensions = class[<System.Runtime.CompilerServices.Nullable(0)>]
type RelationalDatabaseFacadeExtensions = classPublic Module RelationalDatabaseFacadeExtensions- 继承
-
RelationalDatabaseFacadeExtensions
- 特性
方法
| 名称 | 说明 |
|---|---|
| BeginTransaction(DatabaseFacade, IsolationLevel) |
使用给定 IsolationLevel项启动新事务。 |
| BeginTransactionAsync(DatabaseFacade, IsolationLevel, CancellationToken) |
异步启动具有给定 IsolationLevel的新事务。 |
| CloseConnection(DatabaseFacade) |
关闭基础 DbConnection。 |
| CloseConnectionAsync(DatabaseFacade) |
关闭基础 DbConnection。 |
| ExecuteSql(DatabaseFacade, FormattableString) |
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken) |
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| ExecuteSqlCommand(DatabaseFacade, FormattableString) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。
与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - |
| ExecuteSqlCommand(DatabaseFacade, RawSqlString, IEnumerable<Object>) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。 与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 还可以考虑使用 ExecuteSqlInterpolated 来使用内插字符串语法来创建参数。 |
| ExecuteSqlCommand(DatabaseFacade, RawSqlString, Object[]) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。
与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - |
| ExecuteSqlCommand(DatabaseFacade, String, Object[]) |
返回的DatabaseFacade扩展方法Database只能与关系数据库提供程序一起使用。 |
| ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。
与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。
与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。 与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 还可以考虑使用 ExecuteSqlInterpolated 来使用内插字符串语法来创建参数。 |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[]) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。
与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - |
| ExecuteSqlCommandAsync(DatabaseFacade, String, CancellationToken, Object[]) |
返回的DatabaseFacade扩展方法Database只能与关系数据库提供程序一起使用。 |
| ExecuteSqlInterpolated(DatabaseFacade, FormattableString) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| ExecuteSqlInterpolatedAsync(DatabaseFacade, FormattableString, CancellationToken) |
已过时.
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>) |
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| ExecuteSqlRaw(DatabaseFacade, String, Object[]) |
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken) |
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken) |
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| ExecuteSqlRawAsync(DatabaseFacade, String, Object[]) |
针对数据库执行给定的 SQL，并返回受影响的行数。 |
| GenerateCreateScript(DatabaseFacade) |
生成用于为当前模型创建所有表的脚本。 |
| GetAppliedMigrations(DatabaseFacade) |
获取已应用于目标数据库的所有迁移。 |
| GetAppliedMigrationsAsync(DatabaseFacade, CancellationToken) |
异步获取已应用于目标数据库的所有迁移。 |
| GetCommandTimeout(DatabaseFacade) |
返回为此执行的 DbContext命令设置的超时（以秒为单位）。 |
| GetConnectionString(DatabaseFacade) |
获取为此DbContext配置的基础连接字符串。 |
| GetDbConnection(DatabaseFacade) |
获取此DbContext基础 ADO.NET DbConnection 。 |
| GetMigrations(DatabaseFacade) |
获取在配置的迁移程序集中定义的所有迁移。 |
| GetPendingMigrations(DatabaseFacade) |
获取程序集中定义但尚未应用于目标数据库的所有迁移。 |
| GetPendingMigrationsAsync(DatabaseFacade, CancellationToken) |
异步获取程序集中定义但尚未应用于目标数据库的所有迁移。 |
| HasPendingModelChanges(DatabaseFacade) |
返回 |
| IsRelational(DatabaseFacade) |
返回 |
| Migrate(DatabaseFacade, String) |
将上下文的迁移应用到数据库。 如果数据库尚不存在，将创建数据库。 |
| Migrate(DatabaseFacade) |
将上下文的任何挂起迁移应用到数据库。 如果数据库尚不存在，将创建数据库。 |
| MigrateAsync(DatabaseFacade, CancellationToken) |
将上下文的任何挂起迁移异步应用到数据库。 如果数据库尚不存在，将创建数据库。 |
| MigrateAsync(DatabaseFacade, String, CancellationToken) |
将上下文的迁移异步应用到数据库。 如果数据库尚不存在，将创建数据库。 |
| OpenConnection(DatabaseFacade) |
打开基础 DbConnection。 |
| OpenConnectionAsync(DatabaseFacade, CancellationToken) |
打开基础 DbConnection。 |
| SetCommandTimeout(DatabaseFacade, Nullable<Int32>) |
将超时（以秒为单位）设置为用于对此 DbContext执行的命令。 |
| SetCommandTimeout(DatabaseFacade, TimeSpan) |
设置用于使用此 DbContext超时执行的命令的超时。 |
| SetConnectionString(DatabaseFacade, String) |
设置为此DbContext配置的基础连接字符串。 |
| SetDbConnection(DatabaseFacade, DbConnection, Boolean) |
为此设置基础 ADO.NET DbConnectionDbContext。 |
| SetDbConnection(DatabaseFacade, DbConnection) |
为此设置基础 ADO.NET DbConnectionDbContext。 |
| SqlQuery<TResult>(DatabaseFacade, FormattableString) |
基于原始 SQL 查询创建 LINQ 查询，该查询返回数据库提供程序本机支持的标量类型的结果集。 |
| SqlQueryRaw<TResult>(DatabaseFacade, String, Object[]) |
基于原始 SQL 查询创建 LINQ 查询，该查询返回数据库提供程序本机支持的标量类型的结果集。 |
| UseTransaction(DatabaseFacade, DbTransaction, Guid) |
设置 |
| UseTransaction(DatabaseFacade, DbTransaction) |
设置 |
| UseTransactionAsync(DatabaseFacade, DbTransaction, CancellationToken) |
设置 |
| UseTransactionAsync(DatabaseFacade, DbTransaction, Guid, CancellationToken) |
设置 |
