Bagikan melalui


IIncludableQueryable<TEntity,TProperty> Antarmuka

Definisi

Mendukung operator rantai Include/ThenInclude yang dapat dikueri.

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)

Jenis parameter

TEntity

Jenis entitas.

Parameter jenis ini bersifat kovarian. Artinya, Anda bisa menggunakan jenis yang Anda tentukan atau jenis apa pun yang lebih banyak diturunkan. Untuk informasi lebih lanjut tentang kovariansi dan kontravariansi, lihat Kovariansi dan Kontravariansi dalam Generik.
TProperty

Jenis properti.

Parameter jenis ini bersifat kovarian. Artinya, Anda bisa menggunakan jenis yang Anda tentukan atau jenis apa pun yang lebih banyak diturunkan. Untuk informasi lebih lanjut tentang kovariansi dan kontravariansi, lihat Kovariansi dan Kontravariansi dalam Generik.
Penerapan

Keterangan

Lihat Implementasi penyedia dan ekstensi database dan Cara kerja kueri EF Core untuk informasi dan contoh selengkapnya.

Metode Ekstensi

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

Tentukan kunci partisi untuk partisi yang digunakan untuk kueri. Diperlukan saat menggunakan token sumber daya yang menyediakan izin berdasarkan kunci partisi untuk autentikasi,

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

Secara asinkron menentukan apakah semua elemen urutan memenuhi suatu kondisi.

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

Secara asinkron menentukan apakah ada elemen urutan yang memenuhi suatu kondisi.

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

Secara asinkron menentukan apakah urutan berisi elemen apa pun.

AsAsyncEnumerable<TSource>(IQueryable<TSource>)

Mengembalikan yang IAsyncEnumerable<T> dapat dijumlahkan secara asinkron.

AsNoTracking<TEntity>(IQueryable<TEntity>)

Pelacak perubahan tidak akan melacak entitas apa pun yang dikembalikan dari kueri LINQ. Jika instans entitas dimodifikasi, ini tidak akan terdeteksi oleh pelacak perubahan dan SaveChanges() tidak akan mempertahankan perubahan tersebut ke database.

AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)

Pelacak perubahan tidak akan melacak entitas apa pun yang dikembalikan dari kueri LINQ. Jika instans entitas dimodifikasi, ini tidak akan terdeteksi oleh pelacak perubahan dan SaveChanges() tidak akan mempertahankan perubahan tersebut ke database.

AsTracking<TEntity>(IQueryable<TEntity>)

Mengembalikan kueri baru di mana pelacak perubahan akan melacak perubahan untuk semua entitas yang dikembalikan. Setiap modifikasi pada instans entitas akan terdeteksi dan bertahan pada database selama SaveChanges().

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

Mengembalikan kueri baru di mana pelacak perubahan akan melacak perubahan atau tidak untuk semua entitas yang dikembalikan, tergantung pada nilai parameter 'track'. Saat melacak, Setiap modifikasi pada instans entitas akan terdeteksi dan bertahan pada database selama SaveChanges(). Saat tidak melacak, jika instans entitas dimodifikasi, ini tidak akan terdeteksi oleh pelacak perubahan dan SaveChanges() tidak akan mempertahankan perubahan tersebut ke database.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung rata-rata urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menentukan apakah urutan berisi elemen tertentu dengan menggunakan perbandingan kesetaraan default.

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

Secara asinkron mengembalikan jumlah elemen dalam urutan yang memenuhi kondisi.

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

Secara asinkron mengembalikan jumlah elemen secara berurutan.

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

Secara asinkron mengembalikan elemen pada indeks tertentu secara berurutan.

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

Secara asinkron mengembalikan elemen pada indeks tertentu secara berurutan, atau nilai default jika indeks berada di luar rentang.

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

Secara asinkron mengembalikan elemen pertama dari urutan yang memenuhi kondisi tertentu.

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

Secara asinkron mengembalikan elemen pertama dari urutan.

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

Secara asinkron mengembalikan elemen pertama dari urutan yang memenuhi kondisi tertentu atau nilai default jika tidak ada elemen tersebut yang ditemukan.

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

Secara asinkron mengembalikan elemen pertama dari urutan, atau nilai default jika urutan tidak berisi elemen.

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

Secara asinkron menghitung hasil kueri dan melakukan tindakan yang ditentukan pada setiap elemen.

IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)

Menentukan bahwa kueri LINQ Kerangka Kerja Entitas saat ini tidak boleh menerapkan navigasi yang dimuat dengan tingkat model.

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

Menentukan bahwa kueri LINQ Kerangka Kerja Entitas saat ini tidak boleh memiliki filter kueri entitas tingkat model yang diterapkan.

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

Menentukan entitas terkait untuk disertakan dalam hasil kueri. Properti navigasi yang akan disertakan ditentukan dimulai dengan jenis entitas yang sedang dikueri (TEntity). Properti navigasi lebih lanjut yang akan disertakan dapat ditambahkan, dipisahkan oleh karakter '.'.

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

Menentukan entitas terkait untuk disertakan dalam hasil kueri. Properti navigasi yang akan disertakan ditentukan dimulai dengan jenis entitas yang sedang dikueri (TEntity). Jika Anda ingin menyertakan jenis tambahan berdasarkan properti navigasi jenis yang disertakan, maka sambungkan panggilan ke ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) setelah panggilan ini.

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

Secara asinkron mengembalikan elemen terakhir dari urutan yang memenuhi kondisi tertentu.

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

Secara asinkron mengembalikan elemen terakhir dari urutan.

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

Secara asinkron mengembalikan elemen terakhir dari urutan yang memenuhi kondisi tertentu atau nilai default jika tidak ada elemen tersebut yang ditemukan.

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

Secara asinkron mengembalikan elemen terakhir dari urutan, atau nilai default jika urutan tidak berisi elemen.

Load<TSource>(IQueryable<TSource>)

Menghitung kueri. Saat menggunakan Kerangka Kerja Entitas, ini menyebabkan hasil kueri dimuat ke dalam konteks terkait. Ini setara dengan memanggil ToList dan kemudian membuang daftar (tanpa overhead benar-benar membuat daftar).

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

Menghitung kueri secara asinkron. Saat menggunakan Kerangka Kerja Entitas, ini menyebabkan hasil kueri dimuat ke dalam konteks terkait. Ini setara dengan memanggil ToList dan kemudian membuang daftar (tanpa overhead benar-benar membuat daftar).

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

Secara asinkron mengembalikan Int64 yang menunjukkan jumlah elemen dalam urutan yang memenuhi kondisi.

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

Secara asinkron mengembalikan Int64 yang menunjukkan jumlah total elemen dalam urutan.

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

Secara asinkron mengembalikan nilai maksimum urutan.

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

Secara asinkron memanggil fungsi proyeksi pada setiap elemen urutan dan mengembalikan nilai maksimum yang dihasilkan.

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

Secara asinkron mengembalikan nilai minimum urutan.

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

Secara asinkron memanggil fungsi proyeksi pada setiap elemen urutan dan mengembalikan nilai minimum yang dihasilkan.

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

Secara asinkron mengembalikan satu-satunya elemen urutan yang memenuhi kondisi tertentu, dan melemparkan pengecualian jika ada lebih dari satu elemen tersebut.

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

Secara asinkron mengembalikan satu-satunya elemen urutan, dan melemparkan pengecualian jika tidak ada tepat satu elemen dalam urutan.

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

Secara asinkron mengembalikan satu-satunya elemen urutan yang memenuhi kondisi tertentu atau nilai default jika tidak ada elemen tersebut; metode ini memberikan pengecualian jika lebih dari satu elemen memenuhi kondisi.

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

Secara asinkron mengembalikan satu-satunya elemen urutan, atau nilai default jika urutannya kosong; metode ini memberikan pengecualian jika ada lebih dari satu elemen dalam urutan.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Secara asinkron menghitung jumlah urutan nilai yang diperoleh dengan memanggil fungsi proyeksi pada setiap elemen urutan input.

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

Menambahkan tag ke kumpulan tag yang terkait dengan kueri EF LINQ. Tag adalah anotasi kueri yang dapat memberikan informasi pelacakan kontekstual di titik yang berbeda dalam alur kueri.

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

Menambahkan tag ke kumpulan tag yang terkait dengan kueri EF LINQ dengan nama file sumber dan baris di mana metode dipanggil yang dapat memberikan informasi pelacakan kontekstual di titik yang berbeda dalam alur kueri.

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

Menentukan data terkait tambahan untuk disertakan lebih lanjut berdasarkan jenis terkait yang baru saja disertakan.

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

Secara asinkron membuat array dari dengan IQueryable<T> menghitungnya secara asinkron.

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

Dictionary<TKey,TValue> Membuat dari dengan IQueryable<T> menghitungnya secara asinkron sesuai dengan fungsi pemilih kunci tertentu dan pembanding.

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

Dictionary<TKey,TValue> Membuat dari IQueryable<T> dengan menghitungnya secara asinkron sesuai dengan fungsi pemilih kunci tertentu.

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

Dictionary<TKey,TValue> Membuat dari dengan IQueryable<T> menghitungnya secara asinkron sesuai dengan fungsi pemilih kunci tertentu, pembanding, dan fungsi pemilih elemen.

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

Dictionary<TKey,TValue> Membuat dari dengan IQueryable<T> menghitungnya secara asinkron sesuai dengan pemilih kunci tertentu dan fungsi pemilih elemen.

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

Secara asinkron menciptakan List<T> dari dari IQueryable<T> dengan menghitungnya secara asinkron.

AsSingleQuery<TEntity>(IQueryable<TEntity>)

Mengembalikan kueri baru yang dikonfigurasi untuk memuat koleksi dalam hasil kueri dalam satu kueri database.

AsSplitQuery<TEntity>(IQueryable<TEntity>)

Mengembalikan kueri baru yang dikonfigurasi untuk memuat koleksi dalam hasil kueri melalui kueri database terpisah.

ExecuteDelete<TSource>(IQueryable<TSource>)

Menghapus semua baris database untuk instans entitas yang cocok dengan kueri LINQ dari database.

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

Secara asinkron menghapus baris database untuk instans entitas yang cocok dengan kueri LINQ dari database.

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

Updates semua baris database untuk instans entitas yang cocok dengan kueri LINQ dari database.

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

Memperbarui baris database secara asinkron untuk instans entitas yang cocok dengan kueri LINQ dari database.

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

Membuat kueri LINQ berdasarkan kueri SQL mentah.

Jika penyedia database mendukung pembuatan pada SQL yang disediakan, Anda dapat menyusun di atas kueri SQL mentah menggunakan operator LINQ - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Seperti halnya API apa pun yang menerima SQL, penting untuk membuat parameter input pengguna apa pun untuk melindungi dari serangan injeksi SQL. Anda dapat menyertakan tempat penampung parameter dalam string kueri SQL lalu menyediakan nilai parameter sebagai argumen tambahan. Nilai parameter apa pun yang Anda berikan akan secara otomatis dikonversi ke DbParameter - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Kelebihan beban ini juga menerima instans DbParameter sebagai nilai parameter. Ini memungkinkan Anda menggunakan parameter bernama dalam string kueri SQL - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

FromSql<TEntity>(IQueryable<TEntity>, FormattableString)
Kedaluwarsa..

Membuat kueri LINQ berdasarkan string terinterpolasi yang mewakili kueri SQL.

Jika penyedia database mendukung pembuatan pada SQL yang disediakan, Anda dapat menyusun di atas kueri SQL mentah menggunakan operator LINQ - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Seperti halnya API apa pun yang menerima SQL, penting untuk membuat parameter input pengguna apa pun untuk melindungi dari serangan injeksi SQL. Anda dapat menyertakan tempat penampung parameter terinterpolasi dalam string kueri SQL. Nilai parameter terinterpolasi apa pun yang Anda berikan akan secara otomatis dikonversi ke DbParameter - context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

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

Membuat kueri LINQ berdasarkan kueri SQL mentah.

Jika penyedia database mendukung pembuatan pada SQL yang disediakan, Anda dapat menyusun di atas kueri SQL mentah menggunakan operator LINQ - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Seperti halnya API apa pun yang menerima SQL, penting untuk membuat parameter input pengguna apa pun untuk melindungi dari serangan injeksi SQL. Anda dapat menyertakan tempat penampung parameter dalam string kueri SQL lalu menyediakan nilai parameter sebagai argumen tambahan. Nilai parameter apa pun yang Anda berikan akan secara otomatis dikonversi ke DbParameter - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Anda juga dapat membuat DbParameter dan menyediakannya sebagai nilai parameter. Ini memungkinkan Anda menggunakan parameter bernama dalam string kueri SQL - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

Berlaku untuk