Database 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
此类的实例从对象 DbContext 获取,可用于管理支持 DbContext 或连接的实际数据库。 这包括创建、删除和检查是否存在数据库。 请注意,通过使用此类的静态方法,只需使用连接(即没有完整上下文)即可执行数据库是否存在的删除和检查。
public class Database
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1001:TypesThatOwnDisposableFieldsShouldBeDisposable", Justification="The DbContextTransaction and EntityTransaction should never be disposed by this class")]
public class Database
type Database = class
Public Class Database
- 继承
-
Database
- 特性
属性
| 名称 | 说明 |
|---|---|
| CommandTimeout |
获取或设置所有上下文操作的超时值(以秒为单位)。 默认值为 null,其中 null 指示将使用基础提供程序的默认值。 |
| Connection |
返回此上下文正在使用的连接。 如果连接尚不存在,则可能会导致创建连接。 |
| CurrentTransaction |
获取基础存储连接登记到的事务。 可以为 null。 |
| DefaultConnectionFactory |
已过时.
从数据库名称或连接字符串创建DbConnection连接工厂时要使用的连接工厂。 |
| Log |
设置此属性以记录由 DbContext 给定委托生成的 SQL。 例如,若要登录到控制台,请将此属性设置为 Write(String). |
方法
| 名称 | 说明 |
|---|---|
| BeginTransaction() |
开始基础存储连接上的事务 |
| BeginTransaction(IsolationLevel) |
使用指定的隔离级别在基础存储连接上开始事务 |
| CompatibleWithModel(Boolean) |
检查数据库是否与当前的 Code First 模型兼容。 |
| Create() |
在数据库服务器上为在后盾上下文中定义的模型创建新数据库。 请注意,在运行数据库初始化策略之前调用此方法将禁用执行该策略。 |
| CreateIfNotExists() |
在数据库服务器上为在后盾上下文中定义的模型创建一个新数据库,但前提是服务器上尚不存在同名的数据库。 |
| Delete() |
如果数据库存在,则删除数据库服务器上的数据库,否则不执行任何操作。 从初始值设定项外部调用此方法会将数据库标记为尚未初始化。 这意味着,如果在删除数据库后再次尝试使用数据库,则任何初始值设定项集都将再次运行,并且通常,将尝试再次自动创建数据库。 |
| Delete(DbConnection) |
如果数据库存在,则删除数据库服务器上的数据库,否则不执行任何操作。 |
| Delete(String) |
如果数据库存在,则删除数据库服务器上的数据库,否则不执行任何操作。 使用给定的数据库名称或连接字符串创建与类文档DbContext中所述相同的方式创建与数据库的连接。 |
| Equals(Object) |
此类的实例从对象 DbContext 获取,可用于管理支持 DbContext 或连接的实际数据库。 这包括创建、删除和检查是否存在数据库。 请注意,通过使用此类的静态方法,只需使用连接(即没有完整上下文)即可执行数据库是否存在的删除和检查。 |
| ExecuteSqlCommand(String, Object[]) |
对数据库执行给定的 DDL/DML 命令。 与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。Database.ExecuteSqlCommand(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。Database.ExecuteSqlCommand(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)] |
| ExecuteSqlCommand(TransactionalBehavior, String, Object[]) |
对数据库执行给定的 DDL/DML 命令。 与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。Database.ExecuteSqlCommand(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。Database.ExecuteSqlCommand(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)] |
| ExecuteSqlCommandAsync(String, CancellationToken, Object[]) |
针对数据库异步执行给定的 DDL/DML 命令。 与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。Database.ExecuteSqlCommandAsync(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。Database.ExecuteSqlCommandAsync(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)] |
| ExecuteSqlCommandAsync(String, Object[]) |
针对数据库异步执行给定的 DDL/DML 命令。 与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。Database.ExecuteSqlCommandAsync(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。Database.ExecuteSqlCommandAsync(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)] |
| ExecuteSqlCommandAsync(TransactionalBehavior, String, CancellationToken, Object[]) |
针对数据库异步执行给定的 DDL/DML 命令。 与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。Database.ExecuteSqlCommandAsync(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。Database.ExecuteSqlCommandAsync(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)] |
| ExecuteSqlCommandAsync(TransactionalBehavior, String, Object[]) |
针对数据库异步执行给定的 DDL/DML 命令。 与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。Database.ExecuteSqlCommandAsync(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。Database.ExecuteSqlCommandAsync(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)] |
| Exists() |
检查服务器上是否存在数据库。 |
| Exists(DbConnection) |
检查服务器上是否存在数据库。 |
| Exists(String) |
检查服务器上是否存在数据库。 使用给定的数据库名称或连接字符串创建与类文档DbContext中所述相同的方式创建与数据库的连接。 |
| GetHashCode() |
此类的实例从对象 DbContext 获取,可用于管理支持 DbContext 或连接的实际数据库。 这包括创建、删除和检查是否存在数据库。 请注意,通过使用此类的静态方法,只需使用连接(即没有完整上下文)即可执行数据库是否存在的删除和检查。 |
| GetType() |
获取当前实例的 Type。 |
| Initialize(Boolean) |
运行在此上下文中注册的 IDatabaseInitializer<TContext> 上下文。 如果“force”设置为 true,则无论是否以前运行初始值设定项,初始值设定项都会运行。 如果在应用运行时删除数据库,并且需要重新初始化数据库,这非常有用。 如果“force”设置为 false,则仅在此应用域中尚未为此上下文、模型和连接运行初始值设定项时才运行。 在开始一些操作之前,通常使用此方法来确保数据库已创建和种子设定,这样懒惰会导致问题,例如当操作是事务的一部分时。 |
| SetInitializer<TContext>(IDatabaseInitializer<TContext>) |
设置要用于给定上下文类型的数据库初始值设定项。 当给定 DbContext 类型用于首次访问数据库时,将调用数据库初始值设定项。 Code First 上下文的默认策略是一 CreateDatabaseIfNotExists<TContext>个实例。 |
| SqlQuery(Type, String, Object[]) |
创建将返回给定类型的元素的原始 SQL 查询。 该类型可以是具有与查询返回的列名称匹配的属性的任意类型,也可以是简单的基元类型。 该类型不必是实体类型。 即使返回的对象类型是实体类型,上下文也永远不会跟踪此查询的结果。 SqlQuery(String, Object[])使用该方法返回上下文跟踪的实体。 |
| SqlQuery<TElement>(String, Object[]) |
创建一个原始 SQL 查询,该查询将返回给定泛型类型的元素。 该类型可以是具有与查询返回的列名称匹配的属性的任意类型,也可以是简单的基元类型。 该类型不必是实体类型。 即使返回的对象类型是实体类型,上下文也永远不会跟踪此查询的结果。 SqlQuery(String, Object[])使用该方法返回上下文跟踪的实体。 |
| ToString() |
此类的实例从对象 DbContext 获取,可用于管理支持 DbContext 或连接的实际数据库。 这包括创建、删除和检查是否存在数据库。 请注意,通过使用此类的静态方法,只需使用连接(即没有完整上下文)即可执行数据库是否存在的删除和检查。 |
| UseTransaction(DbTransaction) |
如果希望 Entity Framework 在该外部事务中执行命令,则用户可以传入在对象外部 Database 创建的数据库事务。 或者,传入 null 以清除框架对该事务的了解。 |