IIncludableQueryable<TEntity,TProperty> Interfaccia

Riferimento

Definizione

Spazio dei nomi:: Microsoft.EntityFrameworkCore.Query

Assembly:: Microsoft.EntityFrameworkCore.dll

Pacchetto:: Microsoft.EntityFrameworkCore v1.0.6

Pacchetto:: Microsoft.EntityFrameworkCore v1.1.6

Pacchetto:: Microsoft.EntityFrameworkCore v2.0.3

Pacchetto:: Microsoft.EntityFrameworkCore v2.1.11

Pacchetto:: Microsoft.EntityFrameworkCore v2.2.6

Pacchetto:: Microsoft.EntityFrameworkCore v3.0.0

Pacchetto:: Microsoft.EntityFrameworkCore v3.1.0

Pacchetto:: Microsoft.EntityFrameworkCore v5.0.0

Pacchetto:: Microsoft.EntityFrameworkCore v6.0.0

Pacchetto:: Microsoft.EntityFrameworkCore v7.0.0

Pacchetto:: Microsoft.EntityFrameworkCore v8.0.0

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Supporta operatori di concatenamento di inclusione/ThenInclude queryable.

public interface IIncludableQueryable<out TEntity,out TProperty> : System.Collections.Generic.IEnumerable<out TEntity>, System.Linq.IQueryable<out TEntity>

type IIncludableQueryable<'Entity, 'Property> = interface
    interface IQueryable<'Entity>
    interface seq<'Entity>
    interface IEnumerable
    interface IQueryable

Public Interface IIncludableQueryable(Of Out TEntity, Out TProperty)
Implements IEnumerable(Of Out TEntity), IQueryable(Of Out TEntity)

Parametri di tipo

TEntity

Tipo di entità.

Questo parametro di tipo è covariante, ovvero puoi usare il tipo specificato o qualsiasi tipo più derivato. Per altre informazioni sulla covarianza e la controvarianza, vedi Covarianza e controvarianza nei generics.

TProperty

Tipo della proprietà.

Implementazioni: IEnumerable<T> IEnumerable<TEntity> IEnumerable IQueryable IQueryable<TEntity>

Commenti

Per altre informazioni e esempi, vedere Implementazione di provider di database e estensioni e come funzionano le query EF Core .

Metodi di estensione

WithPartitionKey<TEntity>(IQueryable<TEntity>, String)	Specificare la chiave di partizione per la partizione usata per la query. Obbligatorio quando si usa un token di risorsa che fornisce l'autorizzazione basata su una chiave di partizione per l'autenticazione,
AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Determina in modo asincrono se tutti gli elementi di una sequenza soddisfano una condizione.
AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Determina in modo asincrono se un elemento di una sequenza soddisfa una condizione.
AnyAsync<TSource>(IQueryable<TSource>, CancellationToken)	Determina in modo asincrono se una sequenza contiene elementi.
AsAsyncEnumerable<TSource>(IQueryable<TSource>)	Restituisce un oggetto IAsyncEnumerable<T> che può essere enumerato in modo asincrono.
AsNoTracking<TEntity>(IQueryable<TEntity>)	Lo strumento di rilevamento delle modifiche non tiene traccia delle entità restituite da una query LINQ. Se le istanze dell'entità vengono modificate, questa operazione non verrà rilevata dal rilevamento delle modifiche e SaveChanges() le modifiche non verranno mantenute nel database.
AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)	Lo strumento di rilevamento delle modifiche non tiene traccia delle entità restituite da una query LINQ. Se le istanze dell'entità vengono modificate, questa operazione non verrà rilevata dal rilevamento delle modifiche e SaveChanges() le modifiche non verranno mantenute nel database.
AsTracking<TEntity>(IQueryable<TEntity>)	Restituisce una nuova query in cui lo strumento di rilevamento delle modifiche continuerà a tenere traccia delle modifiche per tutte le entità restituite. Tutte le modifiche apportate alle istanze dell'entità verranno rilevate e rese persistenti nel database durante SaveChanges().
AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior)	Restituisce una nuova query in cui lo strumento di rilevamento delle modifiche tiene traccia delle modifiche o non per tutte le entità restituite, a seconda del valore del parametro 'track'. Durante il rilevamento, tutte le modifiche apportate alle istanze dell'entità verranno rilevate e rese persistenti nel database durante SaveChanges(). In caso contrario, se le istanze dell'entità vengono modificate, questa operazione non verrà rilevata dal rilevamento delle modifiche e SaveChanges() le modifiche non verranno mantenute nel database.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)	Calcola in modo asincrono la media di una sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken)	Determina in modo asincrono se una sequenza contiene un elemento specificato utilizzando l'operatore di confronto di uguaglianza predefinito.
CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Restituisce in modo asincrono il numero di elementi in una sequenza che soddisfano una condizione.
CountAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono il numero di elementi in una sequenza.
ElementAtAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)	Restituisce in modo asincrono l'elemento in corrispondenza di un indice specificato in una sequenza.
ElementAtOrDefaultAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)	Restituisce in modo asincrono l'elemento in corrispondenza di un indice specificato in una sequenza o un valore predefinito se l'indice non è compreso nell'intervallo.
FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Restituisce in modo asincrono il primo elemento di una sequenza che soddisfa una condizione specificata.
FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono il primo elemento di una sequenza.
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Restituisce in modo asincrono il primo elemento di una sequenza che soddisfa una condizione specificata o un valore predefinito se non viene trovato alcun elemento di questo tipo.
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono il primo elemento di una sequenza o un valore predefinito se la sequenza non contiene elementi.
ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken)	Enumera in modo asincrono i risultati della query ed esegue l'azione specificata su ogni elemento.
IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)	Specifica che nella query LINQ corrente di Entity Framework non devono essere applicati spostamenti eager a livello di modello.
IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)	Specifica che la query LINQ di Entity Framework corrente non deve avere filtri di query di entità a livello di modello applicati.
Include<TEntity>(IQueryable<TEntity>, String)	Specifica le entità correlate da includere nei risultati della query. La proprietà di navigazione da includere viene specificata a partire dal tipo di entità su cui viene eseguita la query (`TEntity`). È possibile aggiungere altre proprietà di navigazione, separate dal carattere '.'.
Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)	Specifica le entità correlate da includere nei risultati della query. La proprietà di navigazione da includere viene specificata a partire dal tipo di entità su cui viene eseguita la query (`TEntity`). Se si desidera includere tipi aggiuntivi in base alle proprietà di navigazione del tipo da includere, concatenare una chiamata a ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) dopo questa chiamata.
LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Restituisce in modo asincrono l'ultimo elemento di una sequenza che soddisfa una condizione specificata.
LastAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono l'ultimo elemento di una sequenza.
LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Restituisce in modo asincrono l'ultimo elemento di una sequenza che soddisfa una condizione specificata o un valore predefinito se non viene trovato alcun elemento di questo tipo.
LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono l'ultimo elemento di una sequenza o un valore predefinito se la sequenza non contiene elementi.
Load<TSource>(IQueryable<TSource>)	Enumera la query. Quando si usa Entity Framework, in questo modo i risultati della query vengono caricati nel contesto associato. Equivale a chiamare ToList e quindi a buttare via l'elenco (senza il sovraccarico di creare effettivamente l'elenco).
LoadAsync<TSource>(IQueryable<TSource>, CancellationToken)	Enumera in modo asincrono la query. Quando si usa Entity Framework, in questo modo i risultati della query vengono caricati nel contesto associato. Equivale a chiamare ToList e quindi a buttare via l'elenco (senza il sovraccarico di creare effettivamente l'elenco).
LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Restituisce in modo asincrono un Int64 oggetto che rappresenta il numero di elementi in una sequenza che soddisfano una condizione.
LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono un Int64 oggetto che rappresenta il numero totale di elementi in una sequenza.
MaxAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono il valore massimo di una sequenza.
MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)	Richiama in modo asincrono una funzione di proiezione su ogni elemento di una sequenza e restituisce il valore massimo risultante.
MinAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono il valore minimo di una sequenza.
MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)	Richiama in modo asincrono una funzione di proiezione su ogni elemento di una sequenza e restituisce il valore minimo risultante.
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Restituisce in modo asincrono l'unico elemento di una sequenza che soddisfa una condizione specificata e genera un'eccezione se esiste più di un elemento di questo tipo.
SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono l'unico elemento di una sequenza e genera un'eccezione se non è presente esattamente un elemento nella sequenza.
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Restituisce in modo asincrono l'unico elemento di una sequenza che soddisfa una condizione specificata o un valore predefinito se tale elemento non esiste; questo metodo genera un'eccezione se più di un elemento soddisfa la condizione.
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	Restituisce in modo asincrono l'unico elemento di una sequenza o un valore predefinito se la sequenza è vuota; questo metodo genera un'eccezione se nella sequenza sono presenti più elementi.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)	Calcola in modo asincrono la somma della sequenza di valori ottenuta richiamando una funzione di proiezione su ogni elemento della sequenza di input.
TagWith<T>(IQueryable<T>, String)	Aggiunge un tag alla raccolta di tag associati a una query LINQ di EF. I tag sono annotazioni di query che possono fornire informazioni di traccia contestuale in punti diversi nella pipeline di query.
TagWithCallSite<T>(IQueryable<T>, String, Int32)	Aggiunge un tag alla raccolta di tag associati a una query LINQ ef con il nome del file di origine e la riga in cui è stato chiamato il metodo che consente di fornire informazioni di traccia contestuale in punti diversi nella pipeline di query.
ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,TPreviousProperty>, Expression<Func<TPreviousProperty,TProperty>>)	Specifica dati correlati aggiuntivi da includere ulteriormente in base a un tipo correlato appena incluso.
ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken)	Crea in modo asincrono una matrice da un IQueryable<T> oggetto enumerandolo in modo asincrono.
ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken)	Crea un Dictionary<TKey,TValue> oggetto da un IQueryable<T> oggetto enumerandolo in modo asincrono in base a una funzione del selettore di chiavi e a un operatore di confronto specificati.
ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken)	Crea un Dictionary<TKey,TValue> oggetto da un IQueryable<T> oggetto enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata.
ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken)	Crea un Dictionary<TKey,TValue> oggetto da un IQueryable<T> oggetto enumerandolo in modo asincrono in base a una funzione del selettore di chiavi, a un operatore di confronto e a una funzione selettore di elementi.
ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken)	Crea un Dictionary<TKey,TValue> oggetto da un IQueryable<T> oggetto enumerandolo in modo asincrono in base a un selettore di chiavi specificato e a una funzione selettore di elementi.
ToListAsync<TSource>(IQueryable<TSource>, CancellationToken)	Crea in modo asincrono un List<T> oggetto da un IQueryable<T> oggetto enumerandolo in modo asincrono.
AsSingleQuery<TEntity>(IQueryable<TEntity>)	Restituisce una nuova query configurata per caricare le raccolte nei risultati della query in una singola query del database.
AsSplitQuery<TEntity>(IQueryable<TEntity>)	Restituisce una nuova query configurata per caricare le raccolte nei risultati della query tramite query di database separate.
ExecuteDelete<TSource>(IQueryable<TSource>)	Elimina tutte le righe di database per le istanze di entità che corrispondono alla query LINQ dal database.
ExecuteDeleteAsync<TSource>(IQueryable<TSource>, CancellationToken)	Elimina in modo asincrono le righe di database per le istanze di entità che corrispondono alla query LINQ dal database.
ExecuteUpdate<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>)	Aggiornamenti tutte le righe di database per le istanze di entità che corrispondono alla query LINQ dal database.
ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>, CancellationToken)	Aggiorna in modo asincrono le righe del database per le istanze di entità che corrispondono alla query LINQ dal database.
FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])	Obsoleta.. Crea una query LINQ basata su una query SQL non elaborata. Se il provider di database supporta la composizione nell'istanza di SQL fornita, è possibile comporre sopra la query SQL non elaborata usando gli operatori LINQ - `context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)`. Come per qualsiasi API che accetta SQL, è importante parametrizzare qualsiasi input dell'utente per proteggersi da un attacco SQL injection. È possibile includere i segnaposto dei parametri nella stringa di query SQL e quindi specificare i valori dei parametri come argomenti aggiuntivi. Tutti i valori dei parametri specificati verranno convertiti automaticamente in dbParameter - `context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)`. Questo overload accetta anche le istanze DbParameter come valori di parametro. In questo modo è possibile usare parametri denominati nella stringa di query SQL : `context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))`
FromSql<TEntity>(IQueryable<TEntity>, FormattableString)	Obsoleta.. Crea una query LINQ basata su una stringa interpolata che rappresenta una query SQL. Se il provider di database supporta la composizione nell'istanza di SQL fornita, è possibile comporre sopra la query SQL non elaborata usando gli operatori LINQ - `context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)`. Come per qualsiasi API che accetta SQL, è importante parametrizzare qualsiasi input utente da proteggere da un attacco SQL injection. È possibile includere i segnaposto dei parametri interpolati nella stringa di query SQL. Tutti i valori dei parametri interpolati forniti verranno convertiti automaticamente in dbParameter - `context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")`.
FromSql<TEntity>(IQueryable<TEntity>, String, Object[])	Crea una query LINQ basata su una query SQL non elaborata. Se il provider di database supporta la composizione in SQL fornito, è possibile comporre nella query SQL non elaborata usando gli operatori LINQ - `context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)`. Come per qualsiasi API che accetta SQL, è importante parametrizzare qualsiasi input utente da proteggere da un attacco SQL injection. È possibile includere i segnaposto dei parametri nella stringa di query SQL e quindi specificare i valori dei parametri come argomenti aggiuntivi. Tutti i valori dei parametri forniti verranno convertiti automaticamente in un oggetto DbParameter - `context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)`. È anche possibile costruire un dbParameter e specificarlo come valore di parametro. In questo modo è possibile usare parametri denominati nella stringa di query SQL - `context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))`

Si applica a

Condividi tramite