DbQuery<TQuery> 类

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

程序包:

Microsoft.EntityFrameworkCore v3.1.0

注意

Use DbSet<T> instead

A DbQuery<TQuery> 可用于查询 . TQuery的实例。 针对 a DbQuery<TQuery> 的 LINQ 查询将转换为针对数据库的查询。

针对 a DbQuery<TQuery> 的 LINQ 查询的结果将包含从数据库返回的结果，并且可能不会反映未保存到数据库的上下文中所做的更改。 例如，结果将不包含新添加的视图，并且可能仍包含标记为要删除的视图。

根据所使用的数据库，可能会根据内存中评估 LINQ 查询 DbQuery<TQuery> 的某些部分，而不是转换为数据库查询。

DbQuery<TQuery> 对象通常从 DbQuery<TQuery> 派生 DbContext 或方法 Query<TQuery>() 上的属性获取。

[System.Obsolete("Use DbSet<T> instead")]
public abstract class DbQuery<TQuery> : Microsoft.EntityFrameworkCore.DbSet<TQuery> where TQuery : class

[<System.Obsolete("Use DbSet<T> instead")>]
type DbQuery<'Query (requires 'Query : null)> = class
    inherit DbSet<'Query (requires 'Query : null)>

Public MustInherit Class DbQuery(Of TQuery)
Inherits DbSet(Of TQuery)

类型参数

TQuery

此视图所操作的视图的类型。

继承

Object

DbSet<TQuery>

DbQuery<TQuery>

特性

ObsoleteAttribute

构造函数

名称	说明
DbQuery<TQuery>()	已过时. A DbQuery<TQuery> 可用于查询 . TQuery的实例。 针对 a DbQuery<TQuery> 的 LINQ 查询将转换为针对数据库的查询。 针对 a DbQuery<TQuery> 的 LINQ 查询的结果将包含从数据库返回的结果，并且可能不会反映未保存到数据库的上下文中所做的更改。 例如，结果将不包含新添加的视图，并且可能仍包含标记为要删除的视图。 根据所使用的数据库，可能会根据内存中评估 LINQ 查询 DbQuery<TQuery> 的某些部分，而不是转换为数据库查询。 DbQuery<TQuery> 对象通常从 DbQuery<TQuery> 派生 DbContext 或方法 Query<TQuery>() 上的属性获取。

属性

名称	说明
Local	已过时. 获取一个 LocalView<TEntity> 表示此集中所有已添加、未更改和已修改实体的本地视图。 (继承自 DbSet<TEntity>)

方法

名称	说明
Add(TEntity)	已过时. 开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， Added 以便在调用时 SaveChanges() 将其插入数据库。 (继承自 DbSet<TEntity>)
AddAsync(TEntity, CancellationToken)	已过时. 开始跟踪给定实体，以及尚未跟踪的任何其他可访问实体， Added 以便在调用时 SaveChanges() 将其插入数据库。 (继承自 DbSet<TEntity>)
AddRange(IEnumerable<TEntity>)	已过时. 开始跟踪给定的实体，以及尚未跟踪的任何其他可访问实体， Added 处于这样的状态，以便在调用时 SaveChanges() 将其插入数据库。 (继承自 DbSet<TEntity>)
AddRange(TEntity[])	已过时. 开始跟踪给定的实体，以及尚未跟踪的任何其他可访问实体， Added 处于这样的状态，以便在调用时 SaveChanges() 将其插入数据库。 (继承自 DbSet<TEntity>)
AddRangeAsync(IEnumerable<TEntity>, CancellationToken)	已过时. 开始跟踪给定的实体，以及尚未跟踪的任何其他可访问实体， Added 处于这样的状态，以便在调用时 SaveChanges() 将其插入数据库。 (继承自 DbSet<TEntity>)
AddRangeAsync(TEntity[])	已过时. 开始跟踪给定的实体，以及尚未跟踪的任何其他可访问实体， Added 处于这样的状态，以便在调用时 SaveChanges() 将其插入数据库。 (继承自 DbSet<TEntity>)
AsAsyncEnumerable()	已过时. 返回类型化为 IAsyncEnumerable<T>. (继承自 DbSet<TEntity>)
AsQueryable()	已过时. 返回类型化为 IQueryable<T>. (继承自 DbSet<TEntity>)
Attach(TEntity)	已过时. 开始跟踪给定实体和默认情况下可以使用状态 Unchanged 从给定实体访问的条目，但有关使用不同状态的情况，请参阅下文。 (继承自 DbSet<TEntity>)
AttachRange(IEnumerable<TEntity>)	已过时. 开始跟踪默认使用 Unchanged 状态从给定实体访问的给定实体和条目，但有关使用不同状态的情况，请参阅下文。 (继承自 DbSet<TEntity>)
AttachRange(TEntity[])	已过时. 开始跟踪默认使用 Unchanged 状态从给定实体访问的给定实体和条目，但有关使用不同状态的情况，请参阅下文。 (继承自 DbSet<TEntity>)
Find(Object[])	已过时. 查找具有给定主键值的实体。 如果上下文正在跟踪具有给定主键值的实体，则会立即返回该实体，而无需向数据库发出请求。 否则，将为具有给定主键值的实体的数据库进行查询，如果找到该实体，则会附加到上下文并返回该实体。 如果未找到任何实体，则返回 null。 (继承自 DbSet<TEntity>)
FindAsync(Object[], CancellationToken)	已过时. 查找具有给定主键值的实体。 如果上下文正在跟踪具有给定主键值的实体，则会立即返回该实体，而无需向数据库发出请求。 否则，将为具有给定主键值的实体的数据库进行查询，如果找到该实体，则会附加到上下文并返回该实体。 如果未找到任何实体，则返回 null。 (继承自 DbSet<TEntity>)
FindAsync(Object[])	已过时. 查找具有给定主键值的实体。 如果上下文正在跟踪具有给定主键值的实体，则会立即返回该实体，而无需向数据库发出请求。 否则，将为具有给定主键值的实体的数据库进行查询，如果找到该实体，则会附加到上下文并返回该实体。 如果未找到任何实体，则返回 null。 (继承自 DbSet<TEntity>)
Remove(TEntity)	已过时. 开始跟踪处于状态的 Deleted 给定实体，以便调用数据库时 SaveChanges() 会将其从数据库中删除。 (继承自 DbSet<TEntity>)
RemoveRange(IEnumerable<TEntity>)	已过时. 开始跟踪处于状态的 Deleted 给定实体，以便在调用数据库时 SaveChanges() 将其从数据库中删除。 (继承自 DbSet<TEntity>)
RemoveRange(TEntity[])	已过时. 开始跟踪处于状态的 Deleted 给定实体，以便在调用数据库时 SaveChanges() 将其从数据库中删除。 (继承自 DbSet<TEntity>)
Update(TEntity)	已过时. 开始跟踪给定实体和默认情况下可以使用状态 Modified 从给定实体访问的条目，但有关使用不同状态的情况，请参阅下文。 (继承自 DbSet<TEntity>)
UpdateRange(IEnumerable<TEntity>)	已过时. 开始跟踪默认使用 Modified 状态从给定实体访问的给定实体和条目，但有关使用不同状态的情况，请参阅下文。 (继承自 DbSet<TEntity>)
UpdateRange(TEntity[])	已过时. 开始跟踪默认使用 Modified 状态从给定实体访问的给定实体和条目，但有关使用不同状态的情况，请参阅下文。 (继承自 DbSet<TEntity>)

显式接口实现

名称	说明
IAsyncEnumerable<TEntity>.GetAsyncEnumerator(CancellationToken)	已过时. 返回枚举将异步对数据库执行查询的一个 IAsyncEnumerator<T> 值。 (继承自 DbSet<TEntity>)
IEnumerable.GetEnumerator()	已过时. 返回枚举 IEnumerator 将针对数据库执行查询以从数据库加载所有实体的查询。 (继承自 DbSet<TEntity>)
IEnumerable<TEntity>.GetEnumerator()	已过时. 返回枚举 IEnumerator<T> 将针对数据库执行查询以从数据库加载所有实体的查询。 (继承自 DbSet<TEntity>)
IInfrastructure<IServiceProvider>.Instance	已过时. 获取用于解析服务的作用域 IServiceProvider 。 (继承自 DbSet<TEntity>)
IListSource.ContainsListCollection	已过时. 获取一个值，该值指示集合是否是 System.Collections.IList 对象的集合。 始终返回 false。 (继承自 DbSet<TEntity>)
IListSource.GetList()	已过时. 尝试将数据直接绑定到 a1 DbSet<TEntity>时，数据绑定框架调用此方法。 (继承自 DbSet<TEntity>)
IQueryable.ElementType	已过时. 获取 IQueryable 元素类型。 (继承自 DbSet<TEntity>)
IQueryable.Expression	已过时. 获取 IQueryable LINQ 表达式。 (继承自 DbSet<TEntity>)
IQueryable.Provider	已过时. 获取 IQueryable 提供程序。 (继承自 DbSet<TEntity>)

扩展方法

名称	说明
AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步确定序列的所有元素是否满足条件。
AnyAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步确定序列是否包含任何元素。
AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步确定序列的任何元素是否满足条件。
AsAsyncEnumerable<TSource>(IQueryable<TSource>)	已过时. 返回一个可以异步枚举的项 IAsyncEnumerable<T> 。
AsNoTracking<TEntity>(IQueryable<TEntity>)	已过时. 更改跟踪器不会跟踪从 LINQ 查询返回的任何实体。 如果修改实体实例，则更改跟踪器不会检测到此情况，并且 SaveChanges() 不会将这些更改保存到数据库。
AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior)	已过时. 返回一个新查询，更改跟踪器将跟踪所返回的所有实体的更改，具体取决于“track”参数的值。 跟踪时，将检测对实体实例所做的任何修改，并将其保存到数据库中 SaveChanges()。 如果未跟踪，如果修改实体实例，则更改跟踪器不会检测到此情况，并且 SaveChanges() 不会将这些更改保存到数据库。
AsTracking<TEntity>(IQueryable<TEntity>)	已过时. 返回一个新查询，其中更改跟踪器将跟踪返回的所有实体的更改。 在数据库中 SaveChanges()，将检测并持久保存对实体实例所做的任何修改。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的平均值。
ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken)	已过时. 使用默认相等比较器异步确定序列是否包含指定的元素。
CountAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列中的元素数。
CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步返回满足条件的序列中的元素数。
CreateProxy<TEntity>(DbSet<TEntity>, Object[])	已过时. 如果已启用代理创建，则为实体类型创建代理实例。
FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列的第一个元素。
FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步返回满足指定条件的序列的第一个元素。
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列的第一个元素;如果序列不包含任何元素，则返回默认值。
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步返回满足指定条件的序列的第一个元素;如果未找到此类元素，则返回默认值。
ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken)	已过时. 异步枚举查询结果，并在每个元素上执行指定的操作。
FromSql<TEntity>(IQueryable<TEntity>, FormattableString)	已过时. 基于表示 SQL 查询的内插字符串创建 LINQ 查询。 如果数据库提供程序支持在提供的 SQL 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写 - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)。 与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含内插参数位置持有者。 你提供的任何内插参数值将自动转换为 DbParameter - context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")。
FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])	已过时. 基于原始 SQL 查询创建 LINQ 查询。 如果数据库提供程序支持在提供的 SQL 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写 - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)。 与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)。 此重载还接受 DbParameter 实例作为参数值。 这允许在 SQL 查询字符串中使用命名参数 - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))
FromSqlInterpolated<TEntity>(DbSet<TEntity>, FormattableString)	基于表示 SQL 查询的内插字符串创建 LINQ 查询。
FromSqlRaw<TEntity>(DbSet<TEntity>, String, Object[])	已过时. 基于原始 SQL 查询创建 LINQ 查询。
GetInfrastructure<T>(IInfrastructure<T>)	已过时. 从正在使用的隐藏 IInfrastructure<T>属性中获取值。 此方法通常由数据库提供程序（和其他扩展）使用。 它通常不用于应用程序代码。
IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)	已过时. 指定当前 Entity Framework LINQ 查询不应应用任何模型级实体查询筛选器。
Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)	已过时. 指定要包含在查询结果中的相关实体。 从要查询TEntity的实体类型（） 开始指定要包含的导航属性。 如果希望基于所包含类型的导航属性包含其他类型，请在此调用后链接调用 ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) 。
Include<TEntity>(IQueryable<TEntity>, String)	已过时. 指定要包含在查询结果中的相关实体。 从要查询TEntity的实体类型（） 开始指定要包含的导航属性。 可以追加要包含的进一步导航属性，用“.”字符分隔。
LastAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列的最后一个元素。
LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步返回满足指定条件的序列的最后一个元素。
LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列的最后一个元素;如果序列不包含任何元素，则返回默认值。
LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步返回满足指定条件的序列的最后一个元素;如果未找到此类元素，则返回默认值。
Load<TSource>(IQueryable<TSource>)	已过时. 枚举查询。 使用 Entity Framework 时，这会导致查询结果加载到关联的上下文中。 这相当于调用 ToList，然后丢弃列表（无需实际创建列表的开销）。
LoadAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步枚举查询。 使用 Entity Framework 时，这会导致查询结果加载到关联的上下文中。 这相当于调用 ToList，然后丢弃列表（无需实际创建列表的开销）。
LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回一个表示序列中元素总数的元素 Int64 。
LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步返回一个 Int64 表示序列中满足条件的元素数。
MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)	已过时. 对序列的每个元素异步调用投影函数，并返回得到的最大值。
MaxAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列的最大值。
MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)	已过时. 对序列的每个元素异步调用投影函数，并返回生成的最小值。
MinAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列的最小值。
SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列的唯一元素，如果序列中没有完全一个元素，则会引发异常。
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步返回满足指定条件的序列的唯一元素，如果存在多个此类元素，则会引发异常。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 异步返回序列的唯一元素;如果序列为空，则返回默认值;如果序列中有多个元素，此方法将引发异常。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	已过时. 异步返回满足指定条件的序列的唯一元素;如果没有此类元素，则返回默认值;如果多个元素满足条件，此方法将引发异常。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)	已过时. 异步计算通过对输入序列的每个元素调用投影函数获取的值序列的总和。
TagWith<T>(IQueryable<T>, String)	已过时. 将标记添加到与 EF LINQ 查询关联的标记集合。 标记是查询注释，可以在查询管道中的不同点提供上下文跟踪信息。
ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 通过异步枚举数组来 IQueryable<T> 异步创建数组。
ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken)	已过时. 通过根据指定的键选择器和元素选择器函数异步枚举它来创建一Dictionary<TKey,TValue>IQueryable<T>个。
ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken)	已过时. Dictionary<TKey,TValue> IQueryable<T>通过根据指定的键选择器函数、比较器和元素选择器函数异步枚举它来创建一个。
ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken)	已过时. 通过根据指定的键选择器函数异步枚举它来创建一个Dictionary<TKey,TValue>IQueryable<T>。
ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken)	已过时. 通过根据指定的键选择器函数和比较器异步枚举它来创建一Dictionary<TKey,TValue>IQueryable<T>个。
ToListAsync<TSource>(IQueryable<TSource>, CancellationToken)	已过时. 通过异步枚举它来异步创建一个List<T>IQueryable<T>。