语言

ObjectContext 类

定义

ObjectContext 是封装 CLR 和数据库之间的连接的顶级对象,充当创建、读取、更新和删除操作的网关。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Maintainability", "CA1506:AvoidExcessiveClassCoupling")]
public class ObjectContext : IDisposable, System.Data.Entity.Infrastructure.IObjectContextAdapter
type ObjectContext = class
    interface IDisposable
    interface IObjectContextAdapter
Public Class ObjectContext
Implements IDisposable, IObjectContextAdapter
继承
ObjectContext
特性
实现

构造函数

名称 说明
ObjectContext(EntityConnection, Boolean)

使用给定的连接和元数据工作区创建 ObjectContext。

ObjectContext(EntityConnection, String)

使用给定的连接和实体容器名称初始化类的新实例 ObjectContext 。

ObjectContext(EntityConnection)

使用给定的连接初始化类的新实例 ObjectContext 。 在构造过程中,元数据工作区将从 EntityConnection 对象中提取。

ObjectContext(String, String)

使用给定连接字符串和实体容器名称初始化 ObjectContext 类的新实例。

ObjectContext(String)

使用给定的连接字符串和默认实体容器名称初始化 ObjectContext 类的新实例。

属性

名称 说明
CommandTimeout

获取或设置所有对象上下文操作的超时值(以秒为单位)。 null 值指示将使用基础提供程序的默认值。

Connection

获取对象上下文使用的连接。

ContextOptions

ObjectContextOptions获取包含影响该操作行为的选项的ObjectContext实例。

DefaultContainerName

获取或设置默认容器名称。

InterceptionContext

返回 DbInterceptionContext 用于此上下文的项。

MetadataWorkspace

获取对象上下文使用的元数据工作区。

ObjectStateManager

获取对象上下文用于跟踪对象更改的对象状态管理器。

QueryProvider

获取与此对象上下文关联的 LINQ 查询提供程序。

TransactionHandler

获取此上下文正在使用的事务处理程序。 如果未启动事务,则为 null。

方法

名称 说明
AcceptAllChanges()

接受对对象上下文中对象所做的所有更改。

AddObject(String, Object)

将对象添加到对象上下文。

ApplyCurrentValues<TEntity>(String, TEntity)

将所提供的对象中的标量值复制到具有相同键的对象中 ObjectContext 。

ApplyOriginalValues<TEntity>(String, TEntity)

将提供的对象的标量值复制到具有相同键的对象 ObjectContext 的原始值集中。

ApplyPropertyChanges(String, Object)
已过时.

将已分离对象中的属性更改应用于已附加到对象上下文的对象。

Attach(IEntityWithKey)

当对象具有实体键时,将对象或对象图附加到对象上下文。

AttachTo(String, Object)

将对象或对象图附加到特定实体集中的对象上下文。

CreateDatabase()

使用当前数据源连接和中 StoreItemCollection 元数据创建数据库。

CreateDatabaseScript()

生成一个数据定义语言(DDL)脚本,该脚本为元数据 StoreItemCollection 创建架构对象(表、主键、外键)。 从 StoreItemCollection 存储架构定义语言 (SSDL) 文件加载元数据。

CreateEntityKey(String, Object)

为特定对象创建实体键,或返回实体键(如果已存在)。

CreateObject<T>()

创建并返回所请求类型的实例。

CreateObjectSet<TEntity>()

创建用于查询、添加、修改和删除指定实体类型的对象的新 ObjectSet<TEntity> 实例。

CreateObjectSet<TEntity>(String)

创建一个新 ObjectSet<TEntity> 实例,该实例用于查询、添加、修改和删除指定类型的对象以及具有指定实体集名称的对象。

CreateProxyTypes(IEnumerable<Type>)

生成一个等效类型,该类型可与提供的枚举中每种类型的 Entity Framework 一起使用。

CreateQuery<T>(String, ObjectParameter[])

使用指定的查询字符串在当前对象上下文中创建一个 ObjectQuery<T> 。

DatabaseExists()

检查指定为当前存储连接中的数据库的数据库是否存在于存储区中。 大多数实际工作是由当前存储连接的 DbProviderServices 实现完成的。

DeleteDatabase()

删除在当前数据源连接中指定为数据库的数据库。

DeleteObject(Object)

标记要删除的对象。

Detach(Object)

从对象上下文中删除对象。

DetectChanges()

确保 ObjectStateEntry 更改与所 ObjectStateManager 跟踪的所有对象中的更改同步。

Dispose()

释放对象上下文使用的资源。

Dispose(Boolean)

释放对象上下文使用的资源。

ExecuteFunction(String, ObjectParameter[])

执行在数据源中定义的存储过程或函数,并在概念模型中表示;放弃从函数返回的任何结果;并返回受执行影响的行数。

ExecuteFunction<TElement>(String, ExecutionOptions, ObjectParameter[])

对默认容器执行给定函数。

ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

执行在数据源中定义的给定存储过程或函数,并在概念模型中使用指定的参数和合并选项表示。 返回类型化 ObjectResult<T> 。

ExecuteFunction<TElement>(String, ObjectParameter[])

使用指定的参数执行在数据源中定义的存储过程或函数,并在概念模型中映射。 返回类型化 ObjectResult<T> 。

ExecuteStoreCommand(String, Object[])

使用现有连接直接对数据源执行任意命令。 该命令是使用服务器的本机查询语言(如 SQL)指定的。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreCommand(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreCommand(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)]

ExecuteStoreCommand(TransactionalBehavior, String, Object[])

使用现有连接直接对数据源执行任意命令。 该命令是使用服务器的本机查询语言(如 SQL)指定的。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreCommand(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreCommand(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)]

ExecuteStoreCommandAsync(String, CancellationToken, Object[])

使用现有连接直接对数据源执行任意命令。 该命令是使用服务器的本机查询语言(如 SQL)指定的。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreCommandAsync(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreCommandAsync(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)]

ExecuteStoreCommandAsync(String, Object[])

使用现有连接直接对数据源执行任意命令。 该命令是使用服务器的本机查询语言(如 SQL)指定的。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreCommandAsync(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreCommandAsync(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)]

ExecuteStoreCommandAsync(TransactionalBehavior, String, CancellationToken, Object[])

使用现有连接直接对数据源执行任意命令。 该命令是使用服务器的本机查询语言(如 SQL)指定的。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreCommandAsync(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreCommandAsync(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)]

ExecuteStoreCommandAsync(TransactionalBehavior, String, Object[])

使用现有连接直接对数据源执行任意命令。 该命令是使用服务器的本机查询语言(如 SQL)指定的。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreCommandAsync(“UPDATE dbo.文章 SET 分级 = 5 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreCommandAsync(“UPDATE dbo.文章 SET Rating = 5 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor)]

ExecuteStoreQuery<TElement>(String, ExecutionOptions, Object[])

直接对数据源执行查询,并返回类型化结果序列。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 上下文不会跟踪结果,请使用指定实体集名称的重载来跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQuery<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQuery<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQuery<TElement>(String, Object[])

直接对数据源执行查询,并返回类型化结果序列。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 上下文不会跟踪结果,请使用指定实体集名称的重载来跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQuery<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQuery<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQuery<TElement>(String, String, ExecutionOptions, Object[])

直接对数据源执行查询,并返回类型化结果序列。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 如果指定了实体集名称,则由上下文跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQuery<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQuery<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQuery<TElement>(String, String, MergeOption, Object[])

直接对数据源执行查询,并返回类型化结果序列。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 如果指定了实体集名称,则由上下文跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQuery<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQuery<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQueryAsync<TElement>(String, CancellationToken, Object[])

异步对数据源执行查询,并返回一系列类型化的结果。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 上下文不会跟踪结果,请使用指定实体集名称的重载来跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQueryAsync<TElement>(String, ExecutionOptions, CancellationToken, Object[])

异步对数据源执行查询,并返回一系列类型化的结果。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 上下文不会跟踪结果,请使用指定实体集名称的重载来跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQueryAsync<TElement>(String, ExecutionOptions, Object[])

异步对数据源执行查询,并返回一系列类型化的结果。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 上下文不会跟踪结果,请使用指定实体集名称的重载来跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQueryAsync<TElement>(String, Object[])

异步对数据源执行查询,并返回一系列类型化的结果。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 上下文不会跟踪结果,请使用指定实体集名称的重载来跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQueryAsync<TElement>(String, String, ExecutionOptions, CancellationToken, Object[])

异步对数据源执行查询,并返回一系列类型化的结果。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 如果指定了实体集名称,则由上下文跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

ExecuteStoreQueryAsync<TElement>(String, String, ExecutionOptions, Object[])

异步对数据源执行查询,并返回一系列类型化的结果。 该查询是使用服务器的本机查询语言(如 SQL)指定的。 如果指定了实体集名称,则由上下文跟踪结果。

与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。ExecuteStoreQueryAsync<Post>(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor);

Finalize()

完成类的 ObjectContext 实例。

GetKnownProxyTypes()

返回所有现有代理类型。

GetObjectByKey(EntityKey)

返回具有指定实体键的对象。

GetObjectType(Type)

返回与指定类型的代理对象关联的 POCO 实体的实体类型。

LoadProperty(Object, String, MergeOption)

通过指定的导航属性并使用指定的合并选项显式加载与所提供的对象相关的对象。

LoadProperty(Object, String)

通过指定的导航属性并使用默认合并选项显式加载与提供的对象相关的对象。

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)

显式加载与指定 LINQ 查询提供的对象相关的对象,并使用指定的合并选项。

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)

显式加载与指定 LINQ 查询提供的对象相关的对象,并使用默认合并选项。

Refresh(RefreshMode, IEnumerable)

使用数据库中的数据更新对象上下文中的对象集合。

Refresh(RefreshMode, Object)

使用数据库中的数据更新对象上下文中的对象。

RefreshAsync(RefreshMode, IEnumerable, CancellationToken)

使用数据库中的数据异步更新对象上下文中的对象集合。

RefreshAsync(RefreshMode, IEnumerable)

使用数据库中的数据异步更新对象上下文中的对象集合。

RefreshAsync(RefreshMode, Object, CancellationToken)

使用数据库中的数据异步更新对象上下文中的对象。

RefreshAsync(RefreshMode, Object)

使用数据库中的数据异步更新对象上下文中的对象。

SaveChanges()

保留对数据库的所有更新,并在对象上下文中重置更改跟踪。

SaveChanges(Boolean)
已过时.

保留对数据库的所有更新,并选择性地重置对象上下文中的更改跟踪。

SaveChanges(SaveOptions)

保留对数据库的所有更新,并选择性地重置对象上下文中的更改跟踪。

SaveChangesAsync()

异步保存对数据库的所有更新,并在对象上下文中重置更改跟踪。

SaveChangesAsync(CancellationToken)

异步保存对数据库的所有更新,并在对象上下文中重置更改跟踪。

SaveChangesAsync(SaveOptions, CancellationToken)

异步保留数据库的所有更新,并选择性地重置对象上下文中的更改跟踪。

SaveChangesAsync(SaveOptions)

异步保留数据库的所有更新,并选择性地重置对象上下文中的更改跟踪。

Translate<TElement>(DbDataReader)

将 DbDataReader 包含实体数据的行转换为所请求实体类型的对象。

Translate<TEntity>(DbDataReader, String, MergeOption)

将 DbDataReader 包含实体数据的行转换为请求实体类型的对象、特定实体集中以及具有指定合并选项的对象。

TryGetObjectByKey(EntityKey, Object)

返回具有指定实体键的对象。

事件

名称 说明
ObjectMaterialized

当从数据源中的数据创建新实体对象作为查询或加载操作的一部分时发生。

SavingChanges

将更改保存到数据源时发生。

显式接口实现

名称 说明
IObjectContextAdapter.ObjectContext

返回自身。 ObjectContext 实现 IObjectContextAdapter 为和 ObjectContext 提供通用接口,这两个接口 DbContext 都将返回基础 ObjectContext。

适用于