DbSet 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
非泛型版本,当生成时实体类型未知时,可以使用该版本 DbSet<TEntity> 。
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification="Name is intentional")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", Justification="Casing is intentional")]
public abstract class DbSet : System.Data.Entity.Infrastructure.DbQuery
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification="Name is intentional")]
public abstract class DbSet : System.Data.Entity.Infrastructure.DbQuery
type DbSet = class
inherit DbQuery
Public MustInherit Class DbSet
Inherits DbQuery
- 继承
- 特性
构造函数
| 名称 | 说明 |
|---|---|
| DbSet() |
从派生类型的构造函数调用时创建一个实例 DbSet ,该构造函数将用作 DbSets 的测试双精度值。 测试双精度值将使用的方法和属性必须由测试双精度型实现,但 AsNoTracking、AsStreaming 除外,默认实现是 no-op的 Include。 |
属性
| 名称 | 说明 |
|---|---|
| ElementType |
IQueryable 元素类型。 (继承自 DbQuery) |
| Local |
获取一个 ObservableCollection<T> 表示此集中所有已添加、未更改和修改实体的本地视图。 此本地视图将在从上下文中添加或删除实体时保持同步。 同样,从本地视图中添加或删除的实体将自动添加到上下文中或从上下文中删除。 |
| Sql |
String获取基础查询的表示形式。 (继承自 DbQuery) |
方法
| 名称 | 说明 |
|---|---|
| Add(Object) |
将给定实体添加到处于“已添加”状态的集中的上下文中,以便调用 SaveChanges 时,该实体将插入数据库。 |
| AddRange(IEnumerable) |
将给定的实体集合添加到该集的上下文中,其中每个实体都处于“已添加”状态,以便调用 SaveChanges 时,该实体将插入数据库。 |
| AsNoTracking() |
返回一个新的查询,其中返回的实体不会缓存在 .DbContext (继承自 DbQuery) |
| AsStreaming() |
已过时.
返回一个新查询,该查询将流式传输结果,而不是缓冲。 (继承自 DbQuery) |
| Attach(Object) |
将给定实体附加到该集基础的上下文。 也就是说,实体将置于处于“未更改”状态的上下文中,就像它已从数据库读取一样。 |
| Cast<TEntity>() |
返回等效的泛型 DbSet<TEntity> 对象。 |
| Create() |
为此集的类型创建实体的新实例。 请注意,此实例不会添加到集或附加到集。 如果基础上下文配置为创建代理,并且实体类型满足创建代理的要求,则返回的实例将是代理。 |
| Create(Type) |
为此集的类型或派生自此集的类型创建实体的新实例。 请注意,此实例不会添加到集或附加到集。 如果基础上下文配置为创建代理,并且实体类型满足创建代理的要求,则返回的实例将是代理。 |
| Equals(Object) |
非泛型版本,当生成时实体类型未知时,可以使用该版本 DbSet<TEntity> 。 |
| Find(Object[]) |
查找具有给定主键值的实体。 如果上下文中存在具有给定主键值的实体,则会立即返回该实体,而无需向存储区发出请求。 否则,会向具有给定主键值的实体的存储区发出请求,如果找到该实体,则会附加到上下文并返回此实体。 如果在上下文或存储中找不到任何实体,则返回 null。 |
| FindAsync(CancellationToken, Object[]) |
异步查找具有给定主键值的实体。 如果上下文中存在具有给定主键值的实体,则会立即返回该实体,而无需向存储区发出请求。 否则,会向具有给定主键值的实体的存储区发出请求,如果找到该实体,则会附加到上下文并返回此实体。 如果在上下文或存储中找不到任何实体,则返回 null。 |
| FindAsync(Object[]) |
异步查找具有给定主键值的实体。 如果上下文中存在具有给定主键值的实体,则会立即返回该实体,而无需向存储区发出请求。 否则,会向具有给定主键值的实体的存储区发出请求,如果找到该实体,则会附加到上下文并返回此实体。 如果在上下文或存储中找不到任何实体,则返回 null。 |
| GetHashCode() |
非泛型版本,当生成时实体类型未知时,可以使用该版本 DbSet<TEntity> 。 |
| GetType() |
非泛型版本,当生成时实体类型未知时,可以使用该版本 DbSet<TEntity> 。 |
| Include(String) |
指定要包含在查询结果中的相关对象。 (继承自 DbQuery) |
| Remove(Object) |
将给定实体标记为“已删除”,以便调用 SaveChanges 时将从数据库中删除该实体。 请注意,在调用此方法之前,实体必须存在于上下文中处于其他状态。 |
| RemoveRange(IEnumerable) |
从上下文中删除给定的实体集合,其中每个实体都放入“已删除”状态,以便调用 SaveChanges 时,将从数据库中删除该实体。 |
| SqlQuery(String, Object[]) |
创建一个原始 SQL 查询,该查询将返回此集中的实体。 默认情况下,返回的实体由上下文跟踪;可以通过调用返回的 DbRawSqlQuery AsNoTracking 来更改此更改。 请注意,返回的实体始终是此集的类型,从不属于派生类型。 如果查询的表或表可能包含其他实体类型的数据,则必须适当写入 SQL 查询,以确保只返回正确类型的实体。 与接受 SQL 的任何 API 一样,必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者,然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 context。Set(typeof(Blog))。SqlQuery(“SELECT * FROM dbo.发布 WHERE Author = @p0“, userSuppliedAuthor;或者,还可以构造 DbParameter 并将其提供给 SqlQuery。 这样,就可以在 SQL 查询字符串中使用命名参数。 context。Set(typeof(Blog))。SqlQuery(“SELECT * FROM dbo.文章 WHERE Author = @author“, new SqlParameter(”@author“, userSuppliedAuthor); |
| ToString() |
返回 String 基础查询的表示形式。 (继承自 DbQuery) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IDbAsyncEnumerable.GetAsyncEnumerator() |
返回枚举将针对数据库执行查询的一个 IDbAsyncEnumerator 值。 (继承自 DbQuery) |
| IEnumerable.GetEnumerator() |
返回枚举将针对数据库执行查询的一个 IEnumerator 值。 (继承自 DbQuery) |
| IListSource.ContainsListCollection |
返回 |
| IListSource.GetList() |
引发一个异常,指示不支持直接绑定到存储查询。 而是使用数据填充 DbSet,例如,使用 Load 扩展方法,然后绑定到本地数据。 对于WPF绑定到 DbSet.Local。 对于Windows 窗体绑定到 DbSet.Local.ToBindingList()。 (继承自 DbQuery) |
| IQueryable.Expression |
IQueryable LINQ 表达式。 (继承自 DbQuery) |
| IQueryable.Provider |
IQueryable 提供程序。 (继承自 DbQuery) |