DbSet<TEntity> Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
DbSet<TEntity>, Örnekleri sorgulamak ve kaydetmek için kullanılabilir TEntity .
Bir öğesine yönelik LINQ sorguları DbSet<TEntity> , veritabanına karşı sorgulara çevrilir.
Bir LINQ sorgusunun bir öğesine karşı sonuçları DbSet<TEntity> veritabanından döndürülen sonuçları içerir ve veritabanında kalıcı olmayan içerikte yapılan değişiklikleri yansıtmayabilir. Örneğin, sonuçlar yeni eklenen varlıklar içermez ve hala silinmek üzere işaretlenmiş varlıklar içerebilir.
Kullanılmakta olan veritabanına bağlı olarak, bir LINQ sorgusunun bazı kısımları bir DbSet<TEntity> veritabanı sorgusuna çevrilmek yerine bellekte değerlendirilemeyebilir.
DbSet<TEntity> nesneler genellikle DbSet<TEntity> türetilmiş veya yönteminden bir özellikten elde edilir DbContext Set<TEntity>() .
public abstract class DbSet<TEntity> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Query.Internal.IAsyncEnumerableAccessor<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.Linq.IQueryable<TEntity> where TEntity : class
public abstract class DbSet<TEntity> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Query.Internal.IAsyncEnumerableAccessor<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.ComponentModel.IListSource, System.Linq.IQueryable<TEntity> where TEntity : class
public abstract class DbSet<TEntity> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, System.Collections.Generic.IAsyncEnumerable<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.ComponentModel.IListSource, System.Linq.IQueryable<TEntity> where TEntity : class
type DbSet<'Entity (requires 'Entity : null)> = class
interface IQueryable<'Entity (requires 'Entity : null)>
interface seq<'Entity (requires 'Entity : null)>
interface IEnumerable
interface IQueryable
interface IAsyncEnumerableAccessor<'Entity (requires 'Entity : null)>
interface IInfrastructure<IServiceProvider>
type DbSet<'Entity (requires 'Entity : null)> = class
interface IQueryable<'Entity (requires 'Entity : null)>
interface seq<'Entity (requires 'Entity : null)>
interface IEnumerable
interface IQueryable
interface IAsyncEnumerableAccessor<'Entity (requires 'Entity : null)>
interface IInfrastructure<IServiceProvider>
interface IListSource
type DbSet<'Entity (requires 'Entity : null)> = class
interface IQueryable<'Entity (requires 'Entity : null)>
interface seq<'Entity (requires 'Entity : null)>
interface IEnumerable
interface IQueryable
interface IAsyncEnumerable<'Entity (requires 'Entity : null)>
interface IInfrastructure<IServiceProvider>
interface IListSource
Public MustInherit Class DbSet(Of TEntity)
Implements IAsyncEnumerableAccessor(Of TEntity), IEnumerable(Of TEntity), IInfrastructure(Of IServiceProvider), IQueryable(Of TEntity)
Public MustInherit Class DbSet(Of TEntity)
Implements IAsyncEnumerableAccessor(Of TEntity), IEnumerable(Of TEntity), IInfrastructure(Of IServiceProvider), IListSource, IQueryable(Of TEntity)
Public MustInherit Class DbSet(Of TEntity)
Implements IAsyncEnumerable(Of TEntity), IEnumerable(Of TEntity), IInfrastructure(Of IServiceProvider), IListSource, IQueryable(Of TEntity)
Tür Parametreleri
- TEntity
Bu küme tarafından üzerinde çalışılan varlık türü.
- Devralma
-
DbSet<TEntity>
- Türetilmiş
- Uygulamalar
-
IInfrastructure<IServiceProvider> Microsoft.EntityFrameworkCore.Query.Internal.IAsyncEnumerableAccessor<TEntity> IEnumerable<T> IEnumerable<TEntity> IEnumerable IQueryable IQueryable<TEntity> IListSource IAsyncEnumerable<TEntity>
Oluşturucular
| DbSet<TEntity>() |
Özellikler
| EntityType |
IEntityTypeBu küme ile ilişkili meta veriler. |
| Local |
LocalView<TEntity>Bu küme içindeki tüm eklenen, değiştirilmeyen ve değiştirilen varlıkların yerel görünümünü temsil eden bir ' ı alır. Varlıklar eklendiğinde veya bağlamdan kaldırıldığından, bu yerel görünüm eşitlenmiş olarak kalır. Benzer şekilde, yerel görünümden eklenen veya kaldırılan varlıklar otomatik olarak bağlamına eklenir veya içerikten kaldırılır. Bu özellik, kümeyi veri ile doldurarak (örneğin, genişletme yöntemi kullanılarak) veri bağlama için kullanılabilir Load<TSource>(IQueryable<TSource>) ve ardından ToObservableCollection() WPF bağlama veya WinForms için çağırarak bu özellik aracılığıyla yerel verilere bağlanıyor ToBindingList() . |
Yöntemler
| Add(TEntity) |
, Added Çağrıldığında veritabanına eklenebilecekleri şekilde, belirtilen varlığı ve henüz izlenmekte olmayan diğer erişilebilir varlıkları izlemeye başlar SaveChanges() . StateYalnızca tek bir varlığın durumunu ayarlamak için kullanın. |
| AddAsync(TEntity, CancellationToken) |
, Added Çağrıldığında veritabanına eklenebilecekleri şekilde, belirtilen varlığı ve henüz izlenmekte olmayan diğer erişilebilir varlıkları izlemeye başlar SaveChanges() . Bu yöntem, zaman uyumsuz olarak veritabanına erişmek için ' Microsoft. EntityFrameworkCore. Metadata. Sqlservervaluegenerationstrateji. Sequencechild o ' tarafından kullanılan özel değer oluşturucularını sağlamak için zaman uyumsuz. Diğer tüm durumlarda, zaman uyumsuz olmayan yöntemin kullanılması gerekir. StateYalnızca tek bir varlığın durumunu ayarlamak için kullanın. |
| AddRange(IEnumerable<TEntity>) |
, Added Çağrıldığında veritabanına eklenebilecekleri şekilde, belirtilen varlıkları ve henüz izlenmekte olmayan diğer erişilebilir varlıkları izlemeye başlar SaveChanges() . |
| AddRange(TEntity[]) |
, Added Çağrıldığında veritabanına eklenebilecekleri şekilde, belirtilen varlıkları ve henüz izlenmekte olmayan diğer erişilebilir varlıkları izlemeye başlar SaveChanges() . |
| AddRangeAsync(IEnumerable<TEntity>, CancellationToken) |
, Added Çağrıldığında veritabanına eklenebilecekleri şekilde, belirtilen varlıkları ve henüz izlenmekte olmayan diğer erişilebilir varlıkları izlemeye başlar SaveChanges() . Bu yöntem, zaman uyumsuz olarak veritabanına erişmek için ' Microsoft. EntityFrameworkCore. Metadata. Sqlservervaluegenerationstrateji. Sequencechild o ' tarafından kullanılan özel değer oluşturucularını sağlamak için zaman uyumsuz. Diğer tüm durumlarda, zaman uyumsuz olmayan yöntemin kullanılması gerekir. |
| AddRangeAsync(TEntity[]) |
, Added Çağrıldığında veritabanına eklenebilecekleri şekilde, belirtilen varlıkları ve henüz izlenmekte olmayan diğer erişilebilir varlıkları izlemeye başlar SaveChanges() . Bu yöntem, zaman uyumsuz olarak veritabanına erişmek için ' Microsoft. EntityFrameworkCore. Metadata. Sqlservervaluegenerationstrateji. Sequencechild o ' tarafından kullanılan özel değer oluşturucularını sağlamak için zaman uyumsuz. Diğer tüm durumlarda, zaman uyumsuz olmayan yöntemin kullanılması gerekir. |
| AsAsyncEnumerable() |
Bu nesneyi olarak yazılmış olarak döndürür IAsyncEnumerable<T> . Bu, her iki arabirimi de genişleten aynı ad alanında uzantı yöntemlerinin belirsizine karşı yardımcı olmak için kullanışlı bir yöntemdir. |
| AsQueryable() |
Bu nesneyi olarak yazılmış olarak döndürür IQueryable<T> . Bu, her iki arabirimi de genişleten aynı ad alanında uzantı yöntemlerinin belirsizine karşı yardımcı olmak için kullanışlı bir yöntemdir. |
| Attach(TEntity) |
, Varsayılan olarak durum kullanılarak belirtilen varlıktan erişilebilen verilen varlığı ve girdileri izlemeye başlar Unchanged , ancak farklı bir durum kullanılacak durumlar için aşağıya bakın. Genellikle, çağrılana kadar hiçbir veritabanı etkileşimi gerçekleştirilmez SaveChanges() . Zaten bağlam tarafından izlenmeyen erişilebilir varlıkları bulmak için gezinti özelliklerinin özyinelemeli araması gerçekleştirilecek. Bulunan tüm varlıklar bağlam tarafından izlenir. Bir varlığın birincil anahtar değeri ayarlandıysa, oluşturulan anahtarları olan varlık türleri için Unchanged durumunda izlenir. Birincil anahtar değeri ayarlanmamışsa, Added durumunda izlenir. Bu, yalnızca yeni varlıkların eklenebilmenizi sağlamaya yardımcı olur. Birincil anahtar özelliği, özellik türü için CLR varsayılandan farklı bir değere ayarlandıysa, bir varlık birincil anahtar değerinin ayarlanmış olduğu kabul edilir. Oluşturulan anahtarlar olmadan varlık türleri için, durum kümesi her zaman olur Unchanged . StateYalnızca tek bir varlığın durumunu ayarlamak için kullanın. |
| AttachRange(IEnumerable<TEntity>) |
, Varsayılan olarak durum kullanılarak verilen varlıklardan erişilebilen verilen varlıkları ve girdileri izlemeye başlar Unchanged , ancak farklı bir durum kullanılacak durumlar için aşağıya bakın. Genellikle, çağrılana kadar hiçbir veritabanı etkileşimi gerçekleştirilmez SaveChanges() . Zaten bağlam tarafından izlenmeyen erişilebilir varlıkları bulmak için gezinti özelliklerinin özyinelemeli araması gerçekleştirilecek. Bulunan tüm varlıklar bağlam tarafından izlenir. Bir varlığın birincil anahtar değeri ayarlandıysa, oluşturulan anahtarları olan varlık türleri için Unchanged durumunda izlenir. Birincil anahtar değeri ayarlanmamışsa, Added durumunda izlenir. Bu, yalnızca yeni varlıkların eklenebilmenizi sağlamaya yardımcı olur. Birincil anahtar özelliği, özellik türü için CLR varsayılandan farklı bir değere ayarlandıysa, bir varlık birincil anahtar değerinin ayarlanmış olduğu kabul edilir. Oluşturulan anahtarlar olmadan varlık türleri için, durum kümesi her zaman olur Unchanged . StateYalnızca tek bir varlığın durumunu ayarlamak için kullanın. |
| AttachRange(TEntity[]) |
, Varsayılan olarak durum kullanılarak verilen varlıklardan erişilebilen verilen varlıkları ve girdileri izlemeye başlar Unchanged , ancak farklı bir durum kullanılacak durumlar için aşağıya bakın. Genellikle, çağrılana kadar hiçbir veritabanı etkileşimi gerçekleştirilmez SaveChanges() . Zaten bağlam tarafından izlenmeyen erişilebilir varlıkları bulmak için gezinti özelliklerinin özyinelemeli araması gerçekleştirilecek. Bulunan tüm varlıklar bağlam tarafından izlenir. Bir varlığın birincil anahtar değeri ayarlandıysa, oluşturulan anahtarları olan varlık türleri için Unchanged durumunda izlenir. Birincil anahtar değeri ayarlanmamışsa, Added durumunda izlenir. Bu, yalnızca yeni varlıkların eklenebilmenizi sağlamaya yardımcı olur. Birincil anahtar özelliği, özellik türü için CLR varsayılandan farklı bir değere ayarlandıysa, bir varlık birincil anahtar değerinin ayarlanmış olduğu kabul edilir. Oluşturulan anahtarlar olmadan varlık türleri için, durum kümesi her zaman olur Unchanged . StateYalnızca tek bir varlığın durumunu ayarlamak için kullanın. |
| Find(Object[]) |
Verilen birincil anahtar değerleriyle bir varlık bulur. Verilen birincil anahtar değerlerine sahip bir varlık bağlam tarafından izleniyorsa, veritabanına istek yapılmadan hemen döndürülür. Aksi halde, belirtilen birincil anahtar değerlerine sahip bir varlık için veritabanına bir sorgu yapılır ve bu varlık bulunursa, içeriğe iliştirilir ve döndürülür. Hiçbir varlık bulunmazsa null döndürülür. |
| FindAsync(Object[]) |
Verilen birincil anahtar değerleriyle bir varlık bulur. Verilen birincil anahtar değerlerine sahip bir varlık bağlam tarafından izleniyorsa, veritabanına istek yapılmadan hemen döndürülür. Aksi halde, belirtilen birincil anahtar değerlerine sahip bir varlık için veritabanına bir sorgu yapılır ve bu varlık bulunursa, içeriğe iliştirilir ve döndürülür. Hiçbir varlık bulunmazsa null döndürülür. |
| FindAsync(Object[], CancellationToken) |
Verilen birincil anahtar değerleriyle bir varlık bulur. Verilen birincil anahtar değerlerine sahip bir varlık bağlam tarafından izleniyorsa, veritabanına istek yapılmadan hemen döndürülür. Aksi halde, belirtilen birincil anahtar değerlerine sahip bir varlık için veritabanına bir sorgu yapılır ve bu varlık bulunursa, içeriğe iliştirilir ve döndürülür. Hiçbir varlık bulunmazsa null döndürülür. |
| Remove(TEntity) |
Çağrıldığında, belirtilen varlığı veritabanından kaldırılacak şekilde izlemeye başlar Deleted SaveChanges() . |
| RemoveRange(IEnumerable<TEntity>) |
Çağrıldığında, söz konusu varlıkları veritabanından kaldırılacak şekilde izlemeye başlar Deleted SaveChanges() . |
| RemoveRange(TEntity[]) |
Çağrıldığında, söz konusu varlıkları veritabanından kaldırılacak şekilde izlemeye başlar Deleted SaveChanges() . |
| Update(TEntity) |
, Varsayılan olarak durum kullanılarak belirtilen varlıktan erişilebilen verilen varlığı ve girdileri izlemeye başlar Modified , ancak farklı bir durum kullanılacak durumlar için aşağıya bakın. Genellikle, çağrılana kadar hiçbir veritabanı etkileşimi gerçekleştirilmez SaveChanges() . Zaten bağlam tarafından izlenmeyen erişilebilir varlıkları bulmak için gezinti özelliklerinin özyinelemeli araması gerçekleştirilecek. Bulunan tüm varlıklar bağlam tarafından izlenir. Bir varlığın birincil anahtar değeri ayarlandıysa, oluşturulan anahtarları olan varlık türleri için Modified durumunda izlenir. Birincil anahtar değeri ayarlanmamışsa, Added durumunda izlenir. Bu, yeni varlıkların eklene, ancak mevcut varlıkların güncelleştirileceği sağlanmasına yardımcı olur. Birincil anahtar özelliği, özellik türü için CLR varsayılandan farklı bir değere ayarlandıysa, bir varlık birincil anahtar değerinin ayarlanmış olduğu kabul edilir. Oluşturulan anahtarlar olmadan varlık türleri için, durum kümesi her zaman olur Modified . StateYalnızca tek bir varlığın durumunu ayarlamak için kullanın. |
| UpdateRange(IEnumerable<TEntity>) |
, Varsayılan olarak durum kullanılarak verilen varlıklardan erişilebilen verilen varlıkları ve girdileri izlemeye başlar Modified , ancak farklı bir durum kullanılacak durumlar için aşağıya bakın. Genellikle, çağrılana kadar hiçbir veritabanı etkileşimi gerçekleştirilmez SaveChanges() . Zaten bağlam tarafından izlenmeyen erişilebilir varlıkları bulmak için gezinti özelliklerinin özyinelemeli araması gerçekleştirilecek. Bulunan tüm varlıklar bağlam tarafından izlenir. Bir varlığın birincil anahtar değeri ayarlandıysa, oluşturulan anahtarları olan varlık türleri için Modified durumunda izlenir. Birincil anahtar değeri ayarlanmamışsa, Added durumunda izlenir. Bu, yeni varlıkların eklene, ancak mevcut varlıkların güncelleştirileceği sağlanmasına yardımcı olur. Birincil anahtar özelliği, özellik türü için CLR varsayılandan farklı bir değere ayarlandıysa, bir varlık birincil anahtar değerinin ayarlanmış olduğu kabul edilir. Oluşturulan anahtarlar olmadan varlık türleri için, durum kümesi her zaman olur Modified . StateYalnızca tek bir varlığın durumunu ayarlamak için kullanın. |
| UpdateRange(TEntity[]) |
, Varsayılan olarak durum kullanılarak verilen varlıklardan erişilebilen verilen varlıkları ve girdileri izlemeye başlar Modified , ancak farklı bir durum kullanılacak durumlar için aşağıya bakın. Genellikle, çağrılana kadar hiçbir veritabanı etkileşimi gerçekleştirilmez SaveChanges() . Zaten bağlam tarafından izlenmeyen erişilebilir varlıkları bulmak için gezinti özelliklerinin özyinelemeli araması gerçekleştirilecek. Bulunan tüm varlıklar bağlam tarafından izlenir. Bir varlığın birincil anahtar değeri ayarlandıysa, oluşturulan anahtarları olan varlık türleri için Modified durumunda izlenir. Birincil anahtar değeri ayarlanmamışsa, Added durumunda izlenir. Bu, yeni varlıkların eklene, ancak mevcut varlıkların güncelleştirileceği sağlanmasına yardımcı olur. Birincil anahtar özelliği, özellik türü için CLR varsayılandan farklı bir değere ayarlandıysa, bir varlık birincil anahtar değerinin ayarlanmış olduğu kabul edilir. Oluşturulan anahtarlar olmadan varlık türleri için, durum kümesi her zaman olur Modified . StateYalnızca tek bir varlığın durumunu ayarlamak için kullanın. |
Belirtik Arabirim Kullanımları
| IAsyncEnumerable<TEntity>.GetAsyncEnumerator(CancellationToken) |
IAsyncEnumerator<T>Numaralandırılabilir bir sorguyu veritabanına karşı zaman uyumsuz olarak yürütecektir. |
| IAsyncEnumerableAccessor<TEntity>.AsyncEnumerable |
IAsyncEnumerable<T>Numaralandırıldıkları zaman, sorguyu veritabanına karşı zaman uyumsuz olarak yürütecektir. |
| IEnumerable.GetEnumerator() |
IEnumeratorNumaralandırıldıktan sonra veritabanındaki tüm varlıkların yüklenmesi için veritabanında bir sorgu yürütülecektir. |
| IEnumerable<TEntity>.GetEnumerator() |
IEnumerator<T>Numaralandırıldıktan sonra veritabanındaki tüm varlıkların yüklenmesi için veritabanında bir sorgu yürütülecektir. |
| IInfrastructure<IServiceProvider>.Instance |
IServiceProviderHizmetleri çözümlemek için kullanılan kapsamı alır. Bu özellik, genel API yüzeyinde doğrudan gösterilmeyen hizmetlerden yararlanarak kullanılması gereken uzantı yöntemleri tarafından kullanılmak üzere tasarlanmıştır. |
| IListSource.ContainsListCollection |
Koleksiyonun System. Collections. IList nesnelerinin bir koleksiyonu olup olmadığını gösteren bir değer alır.
Her zaman |
| IListSource.GetList() |
Bu yöntem, veri bağlama çerçeveleri tarafından doğrudan bir ' a bağlanmaya çalışırken çağrılır DbSet<TEntity> . Bu uygulama her zaman bir özel durum oluşturur DbSet<TEntity> ve veri bağlama çerçevesi koleksiyonun içeriğini istediğinde veritabanına bir sorgunun gönderilmesine neden olur. Bunun yerine, sonuçları bağlama, örneğin, Load<TSource>(IQueryable<TSource>) genişletme yöntemini kullanarak ve ardından Local ToObservableCollection() WPF bağlama Için çağırarak veya WinForms için kullanarak yerel verilere bağlayın ToBindingList() . |
| IQueryable.ElementType |
IQueryable öğe türünü alır. |
| IQueryable.Expression |
IQueryable LINQ Ifadesini alır. |
| IQueryable.Provider |
IQueryable sağlayıcısını alır. |
Uzantı Metotları
| WithPartitionKey<TEntity>(IQueryable<TEntity>, String) |
Sorgu için kullanılan bölüm için bölüm anahtarını belirtin. Kimlik doğrulaması için bir bölüm anahtarına dayalı olarak izin sağlayan bir kaynak belirteci kullanılırken gereklidir. |
| AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz olarak bir dizinin tüm öğelerinin bir koşulu karşılayıp karşılamadığını belirler. |
| AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz bir dizideki herhangi bir öğenin bir koşula uymayacağını zaman uyumsuz olarak belirler. |
| AnyAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz bir sıranın herhangi bir öğe içerip içermediğini belirler. |
| AsAsyncEnumerable<TSource>(IQueryable<TSource>) |
IAsyncEnumerable<T>Zaman uyumsuz olarak Numaralandırılabilir bir döndürür. |
| AsNoTracking<TEntity>(IQueryable<TEntity>) |
Değişiklik İzleyicisi, bir LINQ sorgusundan döndürülen varlıkların hiçbirini izlemecektir. Varlık örnekleri değiştirilirse, bu değişiklik İzleyici tarafından algılanmaz ve bu SaveChanges() değişiklikleri veritabanında kalıcı hale getirilecektir. Değişiklik izlemenin devre dışı bırakılması, her varlık örneği için değişiklik izlemeyi ayarlama yükünü önlediği için salt okuma senaryolarında kullanışlıdır. Varlık örneklerini işlemek ve bu değişiklikleri veritabanında kalıcı hale getirmek istiyorsanız değişiklik izlemeyi devre dışı bırakmanız gerekir SaveChanges() . Kimlik çözümlemesi gerçekleştirilmeyecektir. Belirli bir anahtara sahip bir varlık sonuç kümesinde farklı bir sonuç içeriyorsa, farklı örnekleri olur. Sorgular için varsayılan izleme davranışı tarafından denetlenebilir QueryTrackingBehavior . |
| AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>) |
Değişiklik İzleyicisi, bir LINQ sorgusundan döndürülen varlıkların hiçbirini izlemecektir. Varlık örnekleri değiştirilirse, bu değişiklik İzleyici tarafından algılanmaz ve bu SaveChanges() değişiklikleri veritabanında kalıcı hale getirilecektir. Değişiklik izlemenin devre dışı bırakılması, her varlık örneği için değişiklik izlemeyi ayarlama yükünü önlediği için salt okuma senaryolarında kullanışlıdır. Varlık örneklerini işlemek ve bu değişiklikleri veritabanında kalıcı hale getirmek istiyorsanız değişiklik izlemeyi devre dışı bırakmanız gerekir SaveChanges() . Kimlik çözümlemesi, sonuç kümesindeki belirli bir anahtara sahip bir varlığın tüm tekrarlarının aynı varlık örneğiyle temsil edildiğinden emin olmak için gerçekleştirilir. Sorgular için varsayılan izleme davranışı tarafından denetlenebilir QueryTrackingBehavior . |
| AsTracking<TEntity>(IQueryable<TEntity>) |
Değişiklik İzleyicisi 'nin döndürülen tüm varlıklar için değişiklikleri tutacağı yeni bir sorgu döndürür. Varlık örneklerinde yapılan herhangi bir değişiklik, sırasında veritabanında algılanır ve kalıcı hale getirilir SaveChanges() . Sorgular için varsayılan izleme davranışı tarafından denetlenebilir QueryTrackingBehavior . |
| AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior) |
Değişiklik izleyicide, ' Track ' parametresinin değerine bağlı olarak, döndürülen tüm varlıklar için değişiklikleri izlemediğinden veya değişiklik izleyicide olmayan yeni bir sorgu döndürür. İzleme sırasında, varlık örneklerinde yapılan tüm değişiklikler, sırasında veritabanında algılanır ve kalıcı hale getirilir SaveChanges() . İzleme olmadığında, varlık örnekleri değiştirilirse bu değişiklik İzleyici tarafından algılanmaz ve bu SaveChanges() değişiklikleri veritabanında kalıcı olmayacaktır. Değişiklik izlemenin devre dışı bırakılması, her varlık örneği için değişiklik izlemeyi ayarlama yükünü önlediği için salt okuma senaryolarında kullanışlıdır. Varlık örneklerini işlemek ve bu değişiklikleri veritabanında kalıcı hale getirmek istiyorsanız değişiklik izlemeyi devre dışı bırakmanız gerekir SaveChanges() . Sorgular için varsayılan izleme davranışı tarafından denetlenebilir QueryTrackingBehavior . |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen bir değer dizisinin ortalamasını hesaplar. |
| ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken) |
Zaman uyumsuz, varsayılan eşitlik karşılaştırıcısı kullanılarak bir sıranın belirtilen bir öğeyi içerip içermediğini belirler. |
| CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz, bir koşulu karşılayan bir dizideki öğe sayısını döndürür. |
| CountAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz olarak dizideki öğe sayısını döndürür. |
| FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz, belirtilen bir koşulu karşılayan bir dizinin ilk öğesini döndürür. |
| FirstAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz, sıradaki ilk öğeyi döndürür. |
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz, belirtilen bir koşulu karşılayan bir dizinin ilk öğesini veya böyle bir öğe bulunmazsa varsayılan değeri döndürür. |
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz, sıranın ilk öğesini veya dizi hiçbir öğe içermiyorsa varsayılan değeri döndürür. |
| ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken) |
Sorgu sonuçlarını zaman uyumsuz olarak numaralandırır ve her öğe için belirtilen eylemi gerçekleştirir. |
| IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>) |
Geçerli Entity Framework LINQ sorgusunun uygulanmış herhangi bir model düzeyi Eager yüklü gezginler olmadığını belirtir. |
| IgnoreQueryFilters<TEntity>(IQueryable<TEntity>) |
Geçerli Entity Framework LINQ sorgusunun hiçbir model düzeyi varlık sorgu filtresi uygulanacağını belirtir. |
| Include<TEntity>(IQueryable<TEntity>, String) |
Sorgu sonuçlarına dahil edilecek ilgili varlıkları belirtir. Dahil edilecek gezinti özelliği, sorgulanan varlık türü () ile başlayarak belirtilmiştir |
| Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>) |
Sorgu sonuçlarına dahil edilecek ilgili varlıkları belirtir. Dahil edilecek gezinti özelliği, sorgulanan varlık türü () ile başlayarak belirtilmiştir |
| LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz, belirtilen bir koşulu karşılayan bir dizinin son öğesini döndürür. |
| LastAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz, sıranın son öğesini döndürür. |
| LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz, belirtilen bir koşulu karşılayan bir sıranın son öğesini veya böyle bir öğe bulunmazsa varsayılan değeri döndürür. |
| LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz, sıranın son öğesini veya dizi hiçbir öğe içermiyorsa varsayılan değeri döndürür. |
| Load<TSource>(IQueryable<TSource>) |
Sorguyu numaralandırır. Entity Framework kullanırken, sorgunun sonuçlarının ilişkili içeriğe yüklenmesine neden olur. Bu, ToList çağırma ve sonra listeyi atma (gerçekten listeyi oluşturma yükü olmadan) ile eşdeğerdir. |
| LoadAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Sorgu zaman uyumsuz olarak numaralandırılır. Entity Framework kullanırken, sorgunun sonuçlarının ilişkili içeriğe yüklenmesine neden olur. Bu, ToList çağırma ve sonra listeyi atma (gerçekten listeyi oluşturma yükü olmadan) ile eşdeğerdir. |
| LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz Int64 , bir koşula uyan öğelerin sayısını temsil eden bir döndürür. |
| LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz Int64 , bir dizideki toplam öğe sayısını temsil eden bir döndürür. |
| MaxAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz, sıranın en büyük değerini döndürür. |
| MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken) |
Sıradaki her öğe için bir projeksiyon işlevini zaman uyumsuz olarak çağırır ve elde edilen en büyük değeri döndürür. |
| MinAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz, sıranın en küçük değerini döndürür. |
| MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken) |
Sıradaki her öğe için bir projeksiyon işlevini zaman uyumsuz olarak çağırır ve elde edilen en küçük değeri döndürür. |
| SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz, belirtilen bir koşulu karşılayan bir dizinin tek öğesini döndürür ve birden fazla öğe varsa bir özel durum oluşturur. |
| SingleAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz, sıranın tek bir öğesini döndürür ve dizide tam olarak bir öğe yoksa bir özel durum oluşturur. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Zaman uyumsuz, belirtilen koşulu veya böyle bir öğe yoksa varsayılan değeri karşılayan bir dizinin tek öğesini döndürür; Bu yöntem, koşulu karşılıyorsa, birden fazla öğe bir özel durum oluşturur. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz, sıranın tek bir öğesini veya dizi boşsa varsayılan değeri döndürür; dizide birden fazla öğe varsa, bu yöntem bir özel durum oluşturur. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken) |
Zaman uyumsuz olarak, giriş dizisinin her öğesinde bir projeksiyon işlevi çağırarak elde edilen değer dizisinin toplamını hesaplar. |
| TagWith<T>(IQueryable<T>, String) |
EF LINQ sorgusuyla ilişkili Etiketler koleksiyonuna bir etiket ekler. Etiketler, sorgu işlem hattının farklı noktalarında bağlamsal izleme bilgileri sağlayabilen sorgu ek açıklamalardır. |
| ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz olarak numaralandırarak bir diziyi bir dizi oluşturur IQueryable<T> . |
| ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken) |
Dictionary<TKey,TValue> IQueryable<T> , Belirtilen bir anahtar Seçici işlevine ve bir karşılaştırıcının zaman uyumsuz olarak numaralandırıldığı bir öğesinden bir oluşturur. |
| ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken) |
Bir Dictionary<TKey,TValue> öğesinden, IQueryable<T> belirtilen bir anahtar Seçici işlevine göre zaman uyumsuz olarak numaralandırarak bir oluşturur. |
| ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken) |
Bir Dictionary<TKey,TValue> öğesinden IQueryable<T> , belirtilen bir anahtar Seçici işlevine, karşılaştırıcının ve bir öğe Seçici işlevine göre zaman uyumsuz olarak numaralandırarak bir oluşturur. |
| ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken) |
Bir Dictionary<TKey,TValue> öğesinden IQueryable<T> , belirtilen bir anahtar seçicisine ve bir öğe Seçici işlevine göre zaman uyumsuz olarak numaralandırarak bir oluşturur. |
| ToListAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Zaman uyumsuz List<T> olarak numaralandırarak bir öğesinden bir oluşturulur IQueryable<T> . |
| GetInfrastructure<T>(IInfrastructure<T>) |
Kullanılarak gizlenen bir özellikten değeri alır IInfrastructure<T> . Bu yöntem genellikle veritabanı sağlayıcıları (ve diğer uzantılar) tarafından kullanılır. Genellikle uygulama kodunda kullanılmaz. IInfrastructure<T> , uygulama kodunda kullanılması amaçlanmayan ancak veritabanı sağlayıcıları tarafından yazılan genişletme yöntemlerinde kullanılabilen özellikleri gizlemek için kullanılır. |
| CreateProxy<TEntity>(DbSet<TEntity>, Action<TEntity>, Object[]) |
Proxy oluşturma açıksa varlık türü için bir proxy örneği oluşturur. |
| CreateProxy<TEntity>(DbSet<TEntity>, Object[]) |
Proxy oluşturma açıksa varlık türü için bir proxy örneği oluşturur. |
| AsSingleQuery<TEntity>(IQueryable<TEntity>) |
Sorgu sonucunda koleksiyonları tek bir veritabanı sorgusuna yüklemek için yapılandırılmış yeni bir sorgu döndürür. Bu davranış genellikle eşzamanlı güncelleştirme yüzdekindeki sonuç tutarlılığını garanti eder (ancak Ayrıntılar veritabanına ve kullanımda olan işlem yalıtım düzeyine göre farklılık gösterebilir). Ancak, sorgu birden çok ilgili koleksiyonu yüklediğinde bu performans sorunlarına neden olabilir. Sorgular için varsayılan sorgu bölme davranışı tarafından denetlenebilir UseQuerySplittingBehavior(QuerySplittingBehavior) . |
| AsSplitQuery<TEntity>(IQueryable<TEntity>) |
Sorgu sonuçlarındaki koleksiyonları ayrı veritabanı sorguları aracılığıyla yüklemek için yapılandırılmış yeni bir sorgu döndürür. Sorgu birden çok koleksiyon yüklediğinde bu davranış performansı önemli ölçüde iyileştirebilir. Ancak, ayrı sorgular kullanıldığından, bu, eşzamanlı güncelleştirmeler gerçekleştiğinde tutarsız sonuçlara neden olabilir. Seri hale getirilebilir veya anlık görüntü işlemleri, bunu azaltmak ve bölünmüş sorgularla tutarlılığı sağlamak için kullanılabilir, ancak bu, diğer performans maliyetlerini ve davranışsal farkı getirebilir. Sorgular için varsayılan sorgu bölme davranışı tarafından denetlenebilir UseQuerySplittingBehavior(QuerySplittingBehavior) . |
| FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[]) |
Kullanımdan kalktı.
Ham SQL sorgusuna dayalı bir LINQ sorgusu oluşturur.
Veritabanı sağlayıcısı sağlanan SQL üzerinde oluşturmayı destekliyorsa, LINQ işleçlerini kullanarak ham SQL sorgusunun üzerine oluşturabilirsiniz-
SQL 'i kabul eden her API 'de olduğu gibi, bir SQL ekleme saldırısına karşı korumak için herhangi bir kullanıcı girişini parametreleştirmek önemlidir. SQL sorgu dizesine parametre yer tutucuları dahil edebilir ve ardından parametre değerlerini ek bağımsız değişkenler olarak sağlayabilirsiniz. Sağladığınız herhangi bir parametre değeri otomatik olarak DbParameter 'a dönüştürülecek-
Bu aşırı yükleme, DbParameter örneklerini de parametre değerleri olarak kabul eder. Bu, SQL sorgu dizesinde adlandırılmış parametreleri kullanmanıza olanak sağlar. |
| FromSql<TEntity>(IQueryable<TEntity>, FormattableString) |
Kullanımdan kalktı.
SQL sorgusunu temsil eden bir enterpolasyonlu dizeye dayalı bir LINQ sorgusu oluşturur.
Veritabanı sağlayıcısı sağlanan SQL üzerinde oluşturmayı destekliyorsa, LINQ işleçlerini kullanarak ham SQL sorgusunun üzerine oluşturabilirsiniz-
SQL 'i kabul eden her API 'de olduğu gibi, bir SQL ekleme saldırısına karşı korumak için herhangi bir kullanıcı girişini parametreleştirmek önemlidir. SQL sorgu dizesine enterpolasyonlu parametre yer tutucuları ekleyebilirsiniz. Sağladığınız tüm enterpolasyonlu parametre değerleri otomatik olarak DbParameter 'a dönüştürülür. |
| FromSql<TEntity>(IQueryable<TEntity>, String, Object[]) |
Ham SQL sorgusuna dayalı bir LINQ sorgusu oluşturur.
Veritabanı sağlayıcısı sağlanan SQL üzerinde oluşturmayı destekliyorsa, LINQ işleçlerini kullanarak ham SQL sorgusunun üzerine oluşturabilirsiniz-
SQL 'i kabul eden her API 'de olduğu gibi, bir SQL ekleme saldırısına karşı korumak için herhangi bir kullanıcı girişini parametreleştirmek önemlidir. SQL sorgu dizesine parametre yer tutucuları dahil edebilir ve ardından parametre değerlerini ek bağımsız değişkenler olarak sağlayabilirsiniz. Sağladığınız herhangi bir parametre değeri otomatik olarak DbParameter 'a dönüştürülecek-
Ayrıca bir DbParameter oluşturup bunu bir parametre değeri olarak sağlayabilirsiniz. Bu, SQL sorgu dizesinde adlandırılmış parametreleri kullanmanıza olanak sağlar. |
| FromSqlInterpolated<TEntity>(DbSet<TEntity>, FormattableString) |
SQL sorgusunu temsil eden bir enterpolasyonlu dizeye dayalı bir LINQ sorgusu oluşturur. Veritabanı sağlayıcısı sağlanan SQL üzerinde oluşturmayı destekliyorsa, LINQ işleçlerini kullanarak ham SQL sorgusunun üzerine oluşturabilirsiniz: context.Blogs.FromSqlInterpolated($"SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)
SQL 'i kabul eden her API 'de olduğu gibi, bir SQL ekleme saldırısına karşı korumak için herhangi bir kullanıcı girişini parametreleştirmek önemlidir. SQL sorgu dizesine enterpolasyonlu parametre yer tutucuları ekleyebilirsiniz. Sağladığınız tüm enterpolasyonlu parametre değerleri otomatik olarak bir DbParameter 'a dönüştürülür: context.Blogs.FromSqlInterpolated($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")
|
| FromSqlRaw<TEntity>(DbSet<TEntity>, String, Object[]) |
Ham SQL sorgusuna dayalı bir LINQ sorgusu oluşturur.
Veritabanı sağlayıcısı sağlanan SQL üzerinde oluşturmayı destekliyorsa, LINQ işleçleri: Context kullanarak ham SQL sorgusunun üzerine oluşturabilirsiniz SQL 'i kabul eden her API 'de olduğu gibi, bir SQL ekleme saldırısına karşı korumak için herhangi bir kullanıcı girişini parametreleştirmek önemlidir. SQL sorgu dizesine parametre yer tutucuları dahil edebilir ve ardından parametre değerlerini ek bağımsız değişkenler olarak sağlayabilirsiniz. Sağladığınız herhangi bir parametre değeri otomatik olarak bir DbParameter 'a dönüştürülür: context.Blogs.FromSqlRaw("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)
Ancak, hiç bir birleştirilmiş veya enterpolasyonlu dize ( Bu aşırı yükleme, DbParameter örneklerini de parametre değerleri olarak kabul eder. Bu, SQL sorgu dizesinde adlandırılmış parametreleri kullanmanıza olanak sağlar: context.Blogs.FromSqlRaw("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))
|