语言

Database 类

定义

此类的实例从对象 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 以清除框架对该事务的了解。

适用于