RelationalDatabaseFacadeExtensions 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
从 Database 返回的 的DatabaseFacade扩展方法，只能与关系数据库提供程序一起使用。
public static class RelationalDatabaseFacadeExtensionstype 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[]) |
从 Database 返回的 的DatabaseFacade扩展方法，只能与关系数据库提供程序一起使用。 |
| 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[]) |
从 Database 返回的 的DatabaseFacade扩展方法，只能与关系数据库提供程序一起使用。 |
| 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.NETDbConnection。 |
| GetMigrations(DatabaseFacade) |
获取在配置的迁移程序集中定义的所有迁移。 |
| GetPendingMigrations(DatabaseFacade) |
获取程序集中定义但尚未应用于目标数据库的所有迁移。 |
| GetPendingMigrationsAsync(DatabaseFacade, CancellationToken) |
异步获取程序集中定义但尚未应用于目标数据库的所有迁移。 |
| HasPendingModelChanges(DatabaseFacade) |
|
| IsRelational(DatabaseFacade) |
|
| Migrate(DatabaseFacade) |
将上下文的任何挂起迁移应用到数据库。 如果数据库尚不存在，将创建该数据库。 |
| MigrateAsync(DatabaseFacade, CancellationToken) |
将上下文的任何挂起迁移异步应用于数据库。 如果数据库尚不存在，将创建该数据库。 |
| OpenConnection(DatabaseFacade) |
打开基础 DbConnection。 |
| OpenConnectionAsync(DatabaseFacade, CancellationToken) |
打开基础 DbConnection。 |
| SetCommandTimeout(DatabaseFacade, Nullable<Int32>) |
设置) 用于使用此 DbContext执行的命令的超时 (（以秒为单位）。 |
| SetCommandTimeout(DatabaseFacade, TimeSpan) |
设置要用于使用此 DbContext执行的命令的超时。 |
| SetConnectionString(DatabaseFacade, String) |
设置为此 DbContext配置的基础连接字符串。 |
| SetDbConnection(DatabaseFacade, DbConnection) |
设置此 DbContext的基础 ADO.NETDbConnection。 |
| SetDbConnection(DatabaseFacade, DbConnection, Boolean) |
设置此 DbContext的基础 ADO.NETDbConnection。 |
| SqlQuery<TResult>(DatabaseFacade, FormattableString) |
基于原始 SQL 查询创建 LINQ 查询，该查询返回数据库提供程序本机支持的标量类型的结果集。 |
| SqlQueryRaw<TResult>(DatabaseFacade, String, Object[]) |
基于原始 SQL 查询创建 LINQ 查询，该查询返回数据库提供程序本机支持的标量类型的结果集。 |
| UseTransaction(DatabaseFacade, DbTransaction) |
DbTransaction设置 要由 上的DbContext数据库操作使用的 。 |
| UseTransaction(DatabaseFacade, DbTransaction, Guid) |
DbTransaction设置要由 上的DbContext数据库操作使用的 。 |
| UseTransactionAsync(DatabaseFacade, DbTransaction, CancellationToken) |
DbTransaction设置要由 上的DbContext数据库操作使用的 。 |
| UseTransactionAsync(DatabaseFacade, DbTransaction, Guid, CancellationToken) |
DbTransaction设置要由 上的DbContext数据库操作使用的 。 |
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈