IIncludableQueryable<TEntity,TProperty> Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Obsługuje operatory tworzenia łańcuchów z możliwością wykonywania zapytań: 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 jednostki.
Ten parametr typu jest kowariantny. Oznacza to, że możesz użyć typu, który został przez Ciebie określony, lub dowolnego typu, który jest bardziej pochodny. Aby uzyskać więcej informacji o kowariancji i kontrawariancji, zobacz Kowariancja i kontrawariancja w typach ogólnych.- TProperty
Typ właściwości.
Ten parametr typu jest kowariantny. Oznacza to, że możesz użyć typu, który został przez Ciebie określony, lub dowolnego typu, który jest bardziej pochodny. Aby uzyskać więcej informacji o kowariancji i kontrawariancji, zobacz Kowariancja i kontrawariancja w typach ogólnych.- Implementuje
Uwagi
Aby uzyskać więcej informacji i przykładów, zobacz Implementacja dostawców i rozszerzeń baz danych oraz Jak działają zapytania EF Core .
Metody rozszerzania
WithPartitionKey<TEntity>(IQueryable<TEntity>, String) |
Określ klucz partycji dla partycji używanej dla zapytania. Wymagane w przypadku korzystania z tokenu zasobu, który zapewnia uprawnienia na podstawie klucza partycji do uwierzytelniania, |
AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie określa, czy wszystkie elementy sekwencji spełniają warunek. |
AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie określa, czy dowolny element sekwencji spełnia warunek. |
AnyAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie określa, czy sekwencja zawiera jakiekolwiek elementy. |
AsAsyncEnumerable<TSource>(IQueryable<TSource>) |
Zwraca element IAsyncEnumerable<T> , który można wyliczać asynchronicznie. |
AsNoTracking<TEntity>(IQueryable<TEntity>) |
Monitor zmian nie będzie śledzić żadnych jednostek zwracanych z zapytania LINQ. Jeśli wystąpienia jednostki zostaną zmodyfikowane, nie zostanie to wykryte przez śledzenie zmian i SaveChanges() nie będzie utrwalać tych zmian w bazie danych. |
AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>) |
Monitor zmian nie będzie śledzić żadnych jednostek zwracanych z zapytania LINQ. Jeśli wystąpienia jednostki zostaną zmodyfikowane, nie zostanie to wykryte przez śledzenie zmian i SaveChanges() nie będzie utrwalać tych zmian w bazie danych. |
AsTracking<TEntity>(IQueryable<TEntity>) |
Zwraca nowe zapytanie, w którym monitor zmian będzie śledzić zmiany dla wszystkich zwracanych jednostek. Wszelkie modyfikacje wystąpień jednostek zostaną wykryte i utrwalone w bazie danych podczas .SaveChanges() |
AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior) |
Zwraca nowe zapytanie, w którym śledzenie zmian będzie śledzić zmiany lub nie dla wszystkich zwracanych jednostek, w zależności od wartości parametru "track". Podczas śledzenia wszelkie modyfikacje wystąpień jednostek zostaną wykryte i utrwalone w bazie danych podczas SaveChanges(). W przypadku braku śledzenia, jeśli wystąpienia jednostek zostaną zmodyfikowane, nie zostanie to wykryte przez monitor zmian i SaveChanges() nie będzie utrwalać tych zmian w bazie danych. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken) |
Asynchronicznie oblicza średnią sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken) |
Asynchronicznie określa, czy sekwencja zawiera określony element przy użyciu domyślnego porównania równości. |
CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca liczbę elementów w sekwencji spełniającej warunek. |
CountAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca liczbę elementów w sekwencji. |
ElementAtAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken) |
Asynchronicznie zwraca element w określonym indeksie w sekwencji. |
ElementAtOrDefaultAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken) |
Asynchronicznie zwraca element w określonym indeksie w sekwencji lub wartość domyślną, jeśli indeks jest poza zakresem. |
FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca pierwszy element sekwencji, który spełnia określony warunek. |
FirstAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca pierwszy element sekwencji. |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca pierwszy element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie zostanie znaleziony. |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca pierwszy element sekwencji lub wartość domyślną, jeśli sekwencja nie zawiera żadnych elementów. |
ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken) |
Asynchronicznie wylicza wyniki zapytania i wykonuje określoną akcję dla każdego elementu. |
IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>) |
Określa, że bieżące zapytanie LINQ platformy Entity Framework nie powinno mieć zastosowanych nawigacji załadowanych na poziomie modelu. |
IgnoreQueryFilters<TEntity>(IQueryable<TEntity>) |
Określa, że bieżące zapytanie LINQ platformy Entity Framework nie powinno mieć zastosowanych filtrów zapytań jednostki na poziomie modelu. |
Include<TEntity>(IQueryable<TEntity>, String) |
Określa powiązane jednostki do uwzględnienia w wynikach zapytania. Właściwość nawigacji, która ma zostać uwzględniona, jest określana, począwszy od typu jednostki, której dotyczy zapytanie ( |
Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>) |
Określa powiązane jednostki do uwzględnienia w wynikach zapytania. Właściwość nawigacji, która ma zostać uwzględniona, jest określana, począwszy od typu jednostki, której dotyczy zapytanie ( |
LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca ostatni element sekwencji, który spełnia określony warunek. |
LastAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca ostatni element sekwencji. |
LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca ostatni element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie zostanie znaleziony. |
LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca ostatni element sekwencji lub wartość domyślną, jeśli sekwencja nie zawiera żadnych elementów. |
Load<TSource>(IQueryable<TSource>) |
Wylicza zapytanie. W przypadku korzystania z programu Entity Framework powoduje to załadowanie wyników zapytania do skojarzonego kontekstu. Jest to równoważne wywołaniu metody ToList, a następnie odrzuceniu listy (bez konieczności rzeczywistego tworzenia listy). |
LoadAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie wylicza zapytanie. W przypadku korzystania z programu Entity Framework powoduje to załadowanie wyników zapytania do skojarzonego kontekstu. Jest to równoważne wywołaniu metody ToList, a następnie odrzuceniu listy (bez konieczności rzeczywistego tworzenia listy). |
LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca wartość Int64 reprezentującą liczbę elementów w sekwencji spełniającej warunek. |
LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca wartość Int64 reprezentującą całkowitą liczbę elementów w sekwencji. |
MaxAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca maksymalną wartość sekwencji. |
MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken) |
Asynchronicznie wywołuje funkcję projekcji dla każdego elementu sekwencji i zwraca maksymalną wynikową wartość. |
MinAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca minimalną wartość sekwencji. |
MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken) |
Asynchronicznie wywołuje funkcję projekcji dla każdego elementu sekwencji i zwraca minimalną wynikową wartość. |
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca jedyny element sekwencji, który spełnia określony warunek, i zgłasza wyjątek, jeśli istnieje więcej niż jeden taki element. |
SingleAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca jedyny element sekwencji i zgłasza wyjątek, jeśli nie ma dokładnie jednego elementu w sekwencji. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca jedyny element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie istnieje; Ta metoda zgłasza wyjątek, jeśli warunek spełnia więcej niż jeden element. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca jedyny element sekwencji lub wartość domyślną, jeśli sekwencja jest pusta; Ta metoda zgłasza wyjątek, jeśli w sekwencji znajduje się więcej niż jeden element. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken) |
Asynchronicznie oblicza sumę sekwencji wartości uzyskanych przez wywołanie funkcji projekcji dla każdego elementu sekwencji wejściowej. |
TagWith<T>(IQueryable<T>, String) |
Dodaje tag do kolekcji tagów skojarzonych z zapytaniem EF LINQ. Tagi to adnotacje zapytań, które mogą dostarczać informacje o śledzeniu kontekstowym w różnych punktach potoku zapytania. |
TagWithCallSite<T>(IQueryable<T>, String, Int32) |
Dodaje tag do kolekcji tagów skojarzonych z zapytaniem EF LINQ z nazwą pliku źródłowego i wierszem, w którym wywoływano metodę, która może dostarczać informacje o śledzeniu kontekstowym w różnych punktach potoku zapytania. |
ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,TPreviousProperty>, Expression<Func<TPreviousProperty,TProperty>>) |
Określa dodatkowe powiązane dane, które mają być dodatkowo uwzględnione na podstawie powiązanego typu, który został właśnie uwzględniony. |
ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie tworzy tablicę na podstawie obiektu IQueryable<T> , wyliczając ją asynchronicznie. |
ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken) |
Tworzy element Dictionary<TKey,TValue> na podstawie IQueryable<T> elementu, wyliczając go asynchronicznie zgodnie z określoną funkcją selektora kluczy i modułem porównawczym. |
ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken) |
Tworzy element Dictionary<TKey,TValue> na podstawie IQueryable<T> elementu, wyliczając go asynchronicznie zgodnie z określoną funkcją selektora kluczy. |
ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken) |
Tworzy element Dictionary<TKey,TValue> na podstawie IQueryable<T> elementu, wyliczając go asynchronicznie zgodnie z określoną funkcją selektora kluczy, modułem porównawczym i funkcją selektora elementów. |
ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken) |
Tworzy element Dictionary<TKey,TValue> na podstawie IQueryable<T> elementu, wyliczając go asynchronicznie zgodnie z określonym selektorem kluczy i funkcją selektora elementów. |
ToListAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie tworzy obiekt List<T> na podstawie obiektu IQueryable<T> , wyliczając go asynchronicznie. |
AsSingleQuery<TEntity>(IQueryable<TEntity>) |
Zwraca nowe zapytanie skonfigurowane do załadowania kolekcji w zapytaniu w wyniku pojedynczego zapytania bazy danych. |
AsSplitQuery<TEntity>(IQueryable<TEntity>) |
Zwraca nowe zapytanie skonfigurowane do ładowania kolekcji w wynikach zapytania za pomocą oddzielnych zapytań bazy danych. |
ExecuteDelete<TSource>(IQueryable<TSource>) |
Usuwa wszystkie wiersze bazy danych dla wystąpień jednostek, które są zgodne z zapytaniem LINQ z bazy danych. |
ExecuteDeleteAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie usuwa wiersze bazy danych dla wystąpień jednostek, które są zgodne z zapytaniem LINQ z bazy danych. |
ExecuteUpdate<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>) |
Aktualizacje wszystkie wiersze bazy danych dla wystąpień jednostki, które są zgodne z zapytaniem LINQ z bazy danych. |
ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>, CancellationToken) |
Asynchronicznie aktualizuje wiersze bazy danych dla wystąpień jednostek, które są zgodne z zapytaniem LINQ z bazy danych. |
FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[]) |
Przestarzałe.
Tworzy zapytanie LINQ na podstawie nieprzetworzonego zapytania SQL.
Jeśli dostawca bazy danych obsługuje tworzenie w podanym języku SQL, możesz utworzyć na podstawie nieprzetworzonego zapytania SQL przy użyciu operatorów LINQ —
Podobnie jak w przypadku każdego interfejsu API, który akceptuje język SQL, ważne jest, aby sparametryzować wszystkie dane wejściowe użytkownika w celu ochrony przed atakiem polegającym na wstrzyknięciu kodu SQL. W ciągu zapytania SQL można uwzględnić posiadacze miejsc parametrów, a następnie podać wartości parametrów jako dodatkowe argumenty. Wszystkie wartości parametrów, które podajesz, zostaną automatycznie przekonwertowane na parametr DbParameter —
To przeciążenie akceptuje również wystąpienia DbParameter jako wartości parametrów. Umożliwia to używanie nazwanych parametrów w ciągu zapytania SQL — |
FromSql<TEntity>(IQueryable<TEntity>, FormattableString) |
Przestarzałe.
Tworzy zapytanie LINQ na podstawie ciągu interpolowanego reprezentującego zapytanie SQL.
Jeśli dostawca bazy danych obsługuje tworzenie w podanym języku SQL, możesz utworzyć na podstawie nieprzetworzonego zapytania SQL przy użyciu operatorów LINQ —
Podobnie jak w przypadku każdego interfejsu API, który akceptuje język SQL, ważne jest, aby sparametryzować wszelkie dane wejściowe użytkownika w celu ochrony przed atakiem polegającym na wstrzyknięciu kodu SQL. W ciągu zapytania SQL można uwzględnić symbole zastępcze parametrów interpolowanych. Wszystkie podane wartości parametrów interpolowanych zostaną automatycznie przekonwertowane na parametr DbParameter — |
FromSql<TEntity>(IQueryable<TEntity>, String, Object[]) |
Tworzy zapytanie LINQ na podstawie nieprzetworzonego zapytania SQL.
Jeśli dostawca bazy danych obsługuje komponowanie w podanym języku SQL, możesz utworzyć na podstawie nieprzetworzonego zapytania SQL przy użyciu operatorów LINQ —
Podobnie jak w przypadku każdego interfejsu API, który akceptuje język SQL, ważne jest, aby sparametryzować wszelkie dane wejściowe użytkownika w celu ochrony przed atakiem polegającym na wstrzyknięciu kodu SQL. W ciągu zapytania SQL można uwzględnić symbole zastępcze parametrów, a następnie podać wartości parametrów jako dodatkowe argumenty. Wszystkie podane wartości parametrów zostaną automatycznie przekonwertowane na parametr DbParameter —
Można również skonstruować parametr DbParameter i podać go jako wartość parametru. Dzięki temu można używać nazwanych parametrów w ciągu zapytania SQL — |