Sdílet prostřednictvím


IIncludableQueryable<TEntity,TProperty> Rozhraní

Definice

Podporuje dotazovatelné operátory řetězení Include/ThenInclude.

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)

Parametry typu

TEntity

Typ entity.

Tento parametr typu je kovariantní. To znamená, že můžete použít buď zadaný typ, nebo libovolný typ, který je více odvozený. Další informace o kovarianci a kontravarianci najdete v tématu popisujícím kovarianci a kontravarianci u parametrického polymorfismu.
TProperty

Typ vlastnosti.

Tento parametr typu je kovariantní. To znamená, že můžete použít buď zadaný typ, nebo libovolný typ, který je více odvozený. Další informace o kovarianci a kontravarianci najdete v tématu popisujícím kovarianci a kontravarianci u parametrického polymorfismu.
Implementuje

Poznámky

Další informace a příklady najdete v tématech Implementace poskytovatelů a rozšíření databází a Jak fungují dotazy EF Core .

Metody rozšíření

WithPartitionKey<TEntity>(IQueryable<TEntity>, String)

Zadejte klíč oddílu pro oddíl použitý pro dotaz. Vyžaduje se při použití tokenu prostředku, který poskytuje oprávnění na základě klíče oddílu pro ověřování.

AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně určuje, zda všechny prvky sekvence splňují podmínku.

AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně určuje, zda některý prvek sekvence splňuje podmínku.

AnyAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně určuje, zda sekvence obsahuje nějaké prvky.

AsAsyncEnumerable<TSource>(IQueryable<TSource>)

Vrátí hodnotu , IAsyncEnumerable<T> která může být vypočítán asynchronně.

AsNoTracking<TEntity>(IQueryable<TEntity>)

Sledování změn nebude sledovat žádné entity, které jsou vráceny z dotazu LINQ. Pokud se instance entit změní, sledování změn to nezjistí a SaveChanges() neuchová tyto změny v databázi.

AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)

Sledování změn nebude sledovat žádné entity, které jsou vráceny z dotazu LINQ. Pokud se instance entit změní, sledování změn to nezjistí a SaveChanges() neuchová tyto změny v databázi.

AsTracking<TEntity>(IQueryable<TEntity>)

Vrátí nový dotaz, ve kterém bude sledování změn sledovat změny pro všechny vrácené entity. Jakékoli změny instancí entit se detekují a zachovají v databázi během SaveChanges().

AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior)

Vrátí nový dotaz, ve kterém bude sledování změn sledovat změny u všech vrácených entit v závislosti na hodnotě parametru track. Při sledování se všechny změny instancí entit detekují a zachovají do databáze během SaveChanges(). Pokud se nesledují instance entit, sledování změn to nezjistí a SaveChanges() nezachová tyto změny v databázi.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

Asynchronně vypočítá průměr sekvence hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken)

Asynchronně určuje, zda sekvence obsahuje zadaný prvek pomocí výchozího porovnávače rovnosti.

CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně vrátí počet prvků v sekvenci, které splňují podmínku.

CountAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí počet prvků v sekvenci.

ElementAtAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

Asynchronně vrátí prvek v zadaném indexu v sekvenci.

ElementAtOrDefaultAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

Asynchronně vrátí prvek v zadaném indexu v sekvenci nebo výchozí hodnotu, pokud je index mimo rozsah.

FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně vrátí první prvek sekvence, která splňuje zadanou podmínku.

FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí první prvek sekvence.

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně vrátí první prvek sekvence, která splňuje zadanou podmínku nebo výchozí hodnotu, pokud není nalezen žádný takový prvek.

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí první prvek sekvence nebo výchozí hodnotu, pokud sekvence neobsahuje žádné prvky.

ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken)

Asynchronně vytvoří výčet výsledků dotazu a provede zadanou akci pro každý prvek.

IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)

Určuje, že aktuální dotaz LINQ entity frameworku by neměl obsahovat žádné navigace s nedočkavým načtením na úrovni modelu.

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

Určuje, že aktuální dotaz LINQ entity frameworku by neměl mít použité žádné filtry dotazů na entity na úrovni modelu.

Include<TEntity>(IQueryable<TEntity>, String)

Určuje související entity, které se mají zahrnout do výsledků dotazu. Vlastnost navigace, která se má zahrnout, se zadává počínaje typem dotazované entity (TEntity). Další navigační vlastnosti, které se mají zahrnout, mohou být připojeny a odděleny znakem ".".

Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)

Určuje související entity, které se mají zahrnout do výsledků dotazu. Vlastnost navigace, která se má zahrnout, se zadává počínaje typem dotazované entity (TEntity). Pokud chcete zahrnout další typy založené na navigačních vlastnostech zahrnutého typu, zřetězte ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) volání po tomto volání.

LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně vrátí poslední prvek sekvence, která splňuje zadanou podmínku.

LastAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí poslední prvek sekvence.

LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně vrátí poslední prvek sekvence, která splňuje zadanou podmínku nebo výchozí hodnotu, pokud není nalezen žádný takový prvek.

LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí poslední prvek sekvence nebo výchozí hodnotu, pokud sekvence neobsahuje žádné prvky.

Load<TSource>(IQueryable<TSource>)

Vytvoří výčet dotazu. Pokud používáte Entity Framework, výsledky dotazu se načtou do přidruženého kontextu. To odpovídá volání funkce ToList a následnému zahodění seznamu (bez režijních nákladů na vytvoření seznamu).

LoadAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vytvoří výčet dotazu. Pokud používáte Entity Framework, výsledky dotazu se načtou do přidruženého kontextu. To odpovídá volání funkce ToList a následnému zahodění seznamu (bez režijních nákladů na vytvoření seznamu).

LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně vrátí hodnotu Int64 , která představuje počet prvků v sekvenci, které splňují podmínku.

LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí hodnotu Int64 , která představuje celkový počet prvků v sekvenci.

MaxAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí maximální hodnotu sekvence.

MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

Asynchronně vyvolá funkci projekce pro každý prvek sekvence a vrátí maximální výslednou hodnotu.

MinAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí minimální hodnotu sekvence.

MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

Asynchronně vyvolá funkci projekce pro každý prvek sekvence a vrátí minimální výslednou hodnotu.

SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně vrátí jediný prvek sekvence, která splňuje zadanou podmínku, a vyvolá výjimku, pokud existuje více než jeden takový prvek.

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí jediný prvek sekvence a vyvolá výjimku, pokud v sekvenci není právě jeden prvek.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Asynchronně vrátí jediný prvek sekvence, která splňuje zadanou podmínku nebo výchozí hodnotu, pokud neexistuje žádný takový prvek; Tato metoda vyvolá výjimku, pokud více než jeden prvek splňuje podmínku.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vrátí jediný prvek sekvence, nebo výchozí hodnotu, pokud sekvence je prázdná; tato metoda vyvolá výjimku, pokud je v sekvenci více než jeden prvek.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

Asynchronně vypočítá součet posloupnosti hodnot, která je získána vyvoláním funkce projekce na každém prvku vstupní sekvence.

TagWith<T>(IQueryable<T>, String)

Přidá značku do kolekce značek přidružených k dotazu EF LINQ. Značky jsou poznámky k dotazům, které můžou poskytovat kontextové informace o trasování v různých bodech kanálu dotazu.

TagWithCallSite<T>(IQueryable<T>, String, Int32)

Přidá značku do kolekce značek přidružených k dotazu EF LINQ s názvem zdrojového souboru a řádkem, kde byla volána metoda, která může poskytnout kontextové informace trasování v různých bodech v kanálu dotazu.

ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,TPreviousProperty>, Expression<Func<TPreviousProperty,TProperty>>)

Určuje další související data, která se mají dále zahrnout na základě souvisejícího typu, který byl právě zahrnut.

ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vytvoří pole z objektu IQueryable<T> tak, že asynchronně vytvoří jeho výčet.

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken)

Dictionary<TKey,TValue> Vytvoří z objektu IQueryable<T> jeho výčet asynchronně podle zadané funkce selektoru klíčů a porovnávače.

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken)

Dictionary<TKey,TValue> Vytvoří z objektu IQueryable<T> jeho výčet asynchronně podle zadané funkce selektoru klíčů.

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken)

Dictionary<TKey,TValue> Vytvoří z objektu IQueryable<T> jeho výčet asynchronně podle zadané funkce selektoru klíčů, porovnávače a funkce selektoru prvků.

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken)

Dictionary<TKey,TValue> Vytvoří z objektu IQueryable<T> jeho výčet asynchronně podle zadaného selektoru klíčů a funkce selektoru prvků.

ToListAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně vytvoří List<T> z objektu IQueryable<T> výčet asynchronně.

AsSingleQuery<TEntity>(IQueryable<TEntity>)

Vrátí nový dotaz, který je nakonfigurovaný tak, aby načetl kolekce ve výsledcích dotazu v jednoúčelovém databázovém dotazu.

AsSplitQuery<TEntity>(IQueryable<TEntity>)

Vrátí nový dotaz, který je nakonfigurovaný tak, aby načítá kolekce ve výsledcích dotazu prostřednictvím samostatných databázových dotazů.

ExecuteDelete<TSource>(IQueryable<TSource>)

Odstraní všechny řádky databáze pro instance entit, které odpovídají dotazu LINQ z databáze.

ExecuteDeleteAsync<TSource>(IQueryable<TSource>, CancellationToken)

Asynchronně odstraňuje řádky databáze pro instance entit, které odpovídají dotazu LINQ z databáze.

ExecuteUpdate<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>)

Aktualizace všechny řádky databáze pro instance entit, které odpovídají dotazu LINQ z databáze.

ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>, CancellationToken)

Asynchronně aktualizuje řádky databáze pro instance entit, které odpovídají dotazu LINQ z databáze.

FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])
Zastaralé.

Vytvoří dotaz LINQ na základě nezpracovaného dotazu SQL.

Pokud poskytovatel databáze podporuje psaní na zadaném SQL, můžete vytvořit nad nezpracovaným dotazem SQL pomocí operátorů LINQ – context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Stejně jako u každého rozhraní API, které přijímá SQL, je důležité parametrizovat jakýkoli uživatelský vstup, aby se chránil před útokem prostřednictvím injektáže SQL. Do řetězce dotazu SQL můžete zahrnout držitelé míst parametrů a pak zadat hodnoty parametrů jako další argumenty. Všechny hodnoty parametrů, které zadáte, se automaticky převedou na DbParameter – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Toto přetížení také přijímá instance DbParameter jako hodnoty parametrů. To vám umožní použít pojmenované parametry v řetězci dotazu SQL – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

FromSql<TEntity>(IQueryable<TEntity>, FormattableString)
Zastaralé.

Vytvoří dotaz LINQ na základě interpolovaného řetězce představujícího dotaz SQL.

Pokud poskytovatel databáze podporuje psaní na zadaném SQL, můžete vytvořit nad nezpracovaným dotazem SQL pomocí operátorů LINQ – context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Stejně jako u každého rozhraní API, které přijímá SQL, je důležité parametrizovat jakýkoli uživatelský vstup, aby se chránil před útokem prostřednictvím injektáže SQL. Do řetězce dotazu SQL můžete zahrnout interpolované držitelé míst parametrů. Všechny hodnoty interpolovaných parametrů, které zadáte, se automaticky převedou na DbParameter – context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

FromSql<TEntity>(IQueryable<TEntity>, String, Object[])

Vytvoří dotaz LINQ na základě nezpracovaného dotazu SQL.

Pokud poskytovatel databáze podporuje psaní na zadaném SQL, můžete vytvořit nad nezpracovaným dotazem SQL pomocí operátorů LINQ – context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Stejně jako u každého rozhraní API, které přijímá SQL, je důležité parametrizovat jakýkoli uživatelský vstup, aby se chránil před útokem prostřednictvím injektáže SQL. Do řetězce dotazu SQL můžete zahrnout držitelé míst parametrů a pak zadat hodnoty parametrů jako další argumenty. Všechny hodnoty parametrů, které zadáte, se automaticky převedou na DbParameter – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Můžete také vytvořit DbParameter a zadat ho do jako hodnotu parametru. To vám umožní použít pojmenované parametry v řetězci dotazu SQL – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

Platí pro