DbContextOptionsBuilder Sınıf

DbContextOptionsBuilderHiçbir seçenek ayarlanmamışsa sınıfın yeni bir örneğini başlatır.

DbContextOptionsBuilderVerilen bir daha fazla yapılandırmak için sınıfının yeni bir örneğini başlatır DbContextOptions .

Herhangi bir seçeneğin yapılandırılıp yapılandırılmadığını gösteren bir değer alır.

Bu, bağlamı yapılandırmak için geçersiz kıldığınızda yararlı olabilir OnConfiguring(DbContextOptionsBuilder) , ancak bazı durumlarda bağlam Oluşturucu aracılığıyla de dışarıdan seçenekler sağlarsınız. Bu özellik, seçeneklerin zaten ayarlanmış olup olmadığını tespit etmek ve içindeki mantığın bazılarını veya tümünü atlamak için kullanılabilir OnConfiguring(DbContextOptionsBuilder) .

Yapılandırılmakta olan seçenekleri alır.

IInterceptorBağlamda kayıtlı olanlara örnekler ekler.

Yakalayıcılar Entity Framework tarafından alınan işlemleri görüntülemek, değiştirmek veya gizlemek için kullanılabilir. IInterceptorAyrıntılar için bkz. belirli uygulamalar. Örneğin, ' ıdbcommandyakalayıcısı '.

Tek bir dinleyici örneği, birden çok farklı dinleyici arabirimi uygulayabilir. Uygulamam, uyguladığı tüm arabirimler için bir yakalayıcısı olarak kaydedilir.

Uzantılar IInterceptor , iç hizmet sağlayıcısına birden çok öğeleri de kaydedebilir. Hem eklenen hem de uygulama yakalayıcılar bulunursa, eklenen yakalayıcılar hizmet sağlayıcısından çözümlendikleri sırada çalıştırılır ve sonra uygulama yakalayıcılar, içeriğe eklendikleri sırada çalıştırılır.

Bu yöntemin birden çok kez çağrılması, her çağrının içeriğe eklendiği tüm yakalayıcılar oluşmasına neden olur. Önceki bir çağrıya eklenen yakalayıcılar, sonraki bir çağrıda eklenen yakalayıcılar tarafından geçersiz kılınmaz.

IInterceptorBağlamda kayıtlı olanlara örnekler ekler.

Yakalayıcılar Entity Framework tarafından alınan işlemleri görüntülemek, değiştirmek veya gizlemek için kullanılabilir. IInterceptorAyrıntılar için bkz. belirli uygulamalar. Örneğin, ' ıdbcommandyakalayıcısı '.

Uzantılar IInterceptor , iç hizmet sağlayıcısına birden çok öğeleri de kaydedebilir. Hem eklenen hem de uygulama yakalayıcılar bulunursa, eklenen yakalayıcılar hizmet sağlayıcısından çözümlendikleri sırada çalıştırılır ve sonra uygulama yakalayıcılar, içeriğe eklendikleri sırada çalıştırılır.

Bu yöntemin birden çok kez çağrılması, her çağrının içeriğe eklendiği tüm yakalayıcılar oluşmasına neden olur. Önceki bir çağrıya eklenen yakalayıcılar, sonraki bir çağrıda eklenen yakalayıcılar tarafından geçersiz kılınmaz.

Entity Framework tarafından oluşturulan uyarıların çalışma zamanı davranışını yapılandırır. Her bir uyarı türü için varsayılan bir davranış ve davranış belirleyebilirsiniz.

Bu yapılandırmanın değiştirilmesinin, EF 'in, performansla ilgili sorunlara neden olabilecek yeni bir iç hizmet sağlayıcısı oluşturmasına neden olabileceğini unutmayın. Genel olarak, belirli bir uygulama için birden fazla veya iki farklı yapılandırmanın kullanılması beklenmektedir.

Uygulama, için bir çağrı aracılığıyla iç hizmet sağlayıcısını ayarladığı takdirde UseInternalServiceProvider(IServiceProvider) Bu seçenek, söz konusu hizmet sağlayıcısının tüm kullanımları için aynı şekilde yapılandırılmalıdır. Bunun yerine UseInternalServiceProvider(IServiceProvider) , EF 'in hizmet sağlayıcılarını yöneteceği ve gerektiğinde yeni örnekler oluşturabilmesi için çağrı yapmayı unutmayın.

Entity Framework tarafından oluşturulan uyarıların çalışma zamanı davranışını yapılandırır. Her bir uyarı türü için varsayılan bir davranış ve davranış belirleyebilirsiniz.

Depo sorgu sonuçlarının işlenmesi sırasında oluşan veri değeri özel durumlarının işlenmesinde ayrıntılı hatalara izin vermez. Bu tür hatalar genellikle varlık özelliklerinin yanlış yapılandırılması nedeniyle oluşur. Örneğin Bir özellik ' int ' türünde olacak şekilde yapılandırıldıysa, ancak depodaki temel alınan veriler gerçekten ' String ' türünde ise, veri değerinin işlenmesi sırasında çalışma zamanında bir özel durum oluşturulur. Bu seçenek etkinleştirildiğinde ve bir veri hatası ile karşılaşıldığında, oluşturulan özel durum, hatayı oluşturan belirli varlık özelliğinin ayrıntılarını içerir.

Bu seçeneğin etkinleştirilmesi, sorgu yürütme sırasında küçük bir performans yükü doğurur.

Uygulama, için bir çağrı aracılığıyla iç hizmet sağlayıcısını ayarladığı takdirde UseInternalServiceProvider(IServiceProvider) Bu seçenek, söz konusu hizmet sağlayıcısının tüm kullanımları için aynı şekilde yapılandırılmalıdır. Bunun yerine UseInternalServiceProvider(IServiceProvider) , EF 'in hizmet sağlayıcılarını yöneteceği ve gerektiğinde yeni örnekler oluşturabilmesi için çağrı yapmayı unutmayın.

Uygulama verilerinin özel durum iletilerine, günlüğe kaydetmeye, vb. dahil edilmesini sağlar. Bu, varlık örneklerinizin özelliklerine atanan değerleri, veritabanına gönderilen komutlara ilişkin parametre değerlerini ve diğer diğer verileri içerebilir. Bu bayrağı yalnızca, bu verilerin duyarlılığına bağlı olarak uygun güvenlik ölçüleri varsa etkinleştirmelisiniz.

Uygulama verilerinin özel durum iletilerine, günlüğe kaydetmeye, vb. dahil edilmesini sağlar. Bu, varlık örneklerinizin özelliklerine atanan değerleri, veritabanına gönderilen komutlara ilişkin parametre değerlerini ve diğer diğer verileri içerebilir. Bu bayrağı yalnızca, bu verilerin duyarlılığına bağlı olarak uygun güvenlik ölçüleri varsa etkinleştirmelisiniz.

Uygulama, için bir çağrı aracılığıyla iç hizmet sağlayıcısını ayarladığı takdirde UseInternalServiceProvider(IServiceProvider) Bu seçenek, söz konusu hizmet sağlayıcısının tüm kullanımları için aynı şekilde yapılandırılmalıdır. Bunun yerine UseInternalServiceProvider(IServiceProvider) , EF 'in hizmet sağlayıcılarını yöneteceği ve gerektiğinde yeni örnekler oluşturabilmesi için çağrı yapmayı unutmayın.

İç hizmet sağlayıcılarının önbelleğe alınmasını etkinleştirilir veya devre dışı bırakır. Önbelleğe almanın devre dışı bırakılması, büyük ölçüde etkileyebilir ve yalnızca test yalıtımı için birçok hizmet sağlayıcısı oluşturan test senaryolarında kullanılmalıdır.

Uygulama, için bir çağrı aracılığıyla iç hizmet sağlayıcısını ayaralıyorsa UseInternalServiceProvider(IServiceProvider) , bu seçeneğin WIL ayarının hiçbir etkisi olmadığını unutmayın.

Sağlanan özel filtre temsilcisiyle filtrelenmiş olayları günlüğe kaydeder. Filtre, bir iletiyi günlüğe kaydetmek için true, ya da günlüğün dışına filtrelemek için false döndürmelidir.

LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>)Tüm olayların varsayılan günlüğü için aşırı yüklemeyi kullanın. LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) Yalnızca belirli kategorilerdeki olayları günlüğe kaydetmek için aşırı yüklemeyi kullanın. LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>)Tam bir özel günlükçü oturumu açmak için aşırı yüklemeyi kullanın.

Sağlanan eylemi kullanarak belirtilen olayları günlüğe kaydeder. Örneğin, olayı konsola kaydetmek için, Options Builder. LogTo (Console. WriteLine, New [] {Coreeventıd. Contextınitialized}) kullanın ContextInitialized .

LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>)Tüm olayların varsayılan günlüğü için aşırı yüklemeyi kullanın. LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>)Yalnızca belirli kategorilerdeki olayları günlüğe kaydetmek için aşırı yüklemeyi kullanın. LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>)Olaylar için özel bir filtre kullanmak üzere aşırı yüklemeyi kullanın. LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>)Tam bir özel günlükçü oturumu açmak için aşırı yüklemeyi kullanın.

Sağlanan eylemi kullanarak belirtilen kategorilerdeki tüm olayları günlüğe kaydeder. Örneğin, kategorideki tüm olayları günlüğe kaydetmek için, Options Builder. LogTo (Console. WriteLine, New [] {DbLoggerCategory.Infrastructure.Name}) kullanın DbLoggerCategory.Infrastructure .

LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>)Tüm olayların varsayılan günlüğü için aşırı yüklemeyi kullanın. LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>)Yalnızca belirli olayları günlüğe kaydetmek için aşırı yüklemeyi kullanın. LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>)Olaylar için özel bir filtre kullanmak üzere aşırı yüklemeyi kullanın. LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>)Tam bir özel günlükçü oturumu açmak için aşırı yüklemeyi kullanın.

Sağlanan eylemi kullanarak günlüğe kaydedilir. Örneğin, konsolda oturum açmak için Options Builder. LogTo (Console. WriteLine) kullanın.

Bu aşırı yükleme, en düşük günlük kayıt düzeyine ve günlük biçimlendirmesinin denetlenmesini sağlar. Şunu kullanın LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) yalnızca belirli olayları günlüğe kaydetmek için aşırı yükleme. LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>)Yalnızca belirli kategorilerdeki olayları günlüğe kaydetmek için aşırı yüklemeyi kullanın. LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>)Olaylar için özel bir filtre kullanmak üzere aşırı yüklemeyi kullanın. LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>)Tam bir özel günlükçü oturumu açmak için aşırı yüklemeyi kullanın.

Özel bir filtre temsilcisiyle filtrelenmiş özel bir günlükçü temsilcisine olayları günlüğe kaydeder. Filtre, bir iletiyi günlüğe kaydetmek için true, ya da günlüğün dışına filtrelemek için false döndürmelidir.

LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>)Tüm olayların varsayılan günlüğü için aşırı yüklemeyi kullanın. LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) Yalnızca belirli kategorilerdeki olayları günlüğe kaydetmek için aşırı yüklemeyi kullanın. LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>)Olaylar için özel bir filtre kullanmak üzere aşırı yüklemeyi kullanın.

Hizmet sözleşmesinin belirli bir uygulamasındaki iç Entity Framework uygulamasını farklı bir uygulamayla değiştirir.

Bu yöntem, EF iç hizmet sağlayıcısında meşru bir şekilde birden çok kez kaydedilebileceği tek bir hizmet örneğini değiştirmek için kullanışlıdır.

Bu yöntem, yalnızca EF iç hizmet sağlayıcısını oluştururken ve yönetirken kullanılabilir. Hizmet sağlayıcı dışarıdan oluşturulup geçiriliyorsa UseInternalServiceProvider(IServiceProvider) , bu hizmet sağlayıcısında, EF 'e geçirilmeden önce değiştirme hizmetleri yapılandırılmalıdır.

Değiştirme hizmeti, yerini aldığı EF hizmeti ile aynı kapsamı alır.

Hizmet sözleşmesinin tüm iç Entity Framework uygulamalarını farklı bir uygulamayla değiştirir.

Bu yöntem, yalnızca EF iç hizmet sağlayıcısını oluştururken ve yönetirken kullanılabilir. Hizmet sağlayıcı dışarıdan oluşturulup geçiriliyorsa UseInternalServiceProvider(IServiceProvider) , bu hizmet sağlayıcısında, EF 'e geçirilmeden önce değiştirme hizmetleri yapılandırılmalıdır.

Değiştirme hizmeti, yerini aldığı EF hizmeti ile aynı kapsamı alır.

IServiceProviderUygulama hizmetlerinden elde edilecek ' i ayarlar. ' AddDbContext ' veya ' AddDbContextPool ' kullanılırken bu otomatik olarak yapılır, bu nedenle bu yöntemin çağrılması gerekir.

IServiceProviderİçeriğin tüm hizmetlerini ' dan çözmeli olduğunu ayarlar. Hiçbiri belirtilmemişse EF, bir hizmet sağlayıcısı oluşturur ve yönetir.

Hizmet sağlayıcısı, Entity Framework için gereken tüm hizmetleri (ve kullanılan veritabanını) içermelidir. Entity Framework Hizmetleri, üzerinde bir genişletme yöntemi kullanılarak kaydedilebilir IServiceCollection . Örneğin, Microsoft SQL Server sağlayıcısı gerekli hizmetleri eklemek için bir AddEntityFrameworkSqlServer () yöntemi içerir.

IServiceProvider DbContextOptions Veya kaydı varsa, bu DbContextOptions<TContext> bağlam örneği için seçenekler olarak kullanılacaktır.

ILoggerFactory ILogger Bu bağlam tarafından gerçekleştirilen günlüğe kaydetme için örnek oluşturmak üzere kullanılacak olan öğesini ayarlar.

' AddDbContextPool ' dahil olmak üzere ' AddDbContext ' yöntemlerinden birini kullanırken bu yöntemi çağırmaya gerek yoktur. Bu yöntemler, ILoggerFactory uygulama hizmeti SAĞLAYıCıSıNDAN EF tarafından kullanılan ' ın elde olduğundan emin olur.

Uygulama, öğesine yapılan bir çağrı aracılığıyla iç hizmet sağlayıcısını ayaralıyorsa, bu yöntem kullanılamaz UseInternalServiceProvider(IServiceProvider) . Bu durumda, bu ILoggerFactory hizmet sağlayıcısında doğrudan yapılandırılmalıdır.

IMemoryCacheBu bağlam tarafından sorgu önbelleği için kullanılacak öğesini ayarlar.

Bellek önbelleğinin değiştirilmesinin, EF 'in performansla ilgili sorunlara neden olabilecek yeni bir iç hizmet sağlayıcısı oluşturmasına neden olabileceğini unutmayın. Genellikle, belirli bir uygulama için birden fazla veya iki farklı örnek kullanılmayacak.

Uygulama, öğesine yapılan bir çağrı aracılığıyla iç hizmet sağlayıcısını ayaralıyorsa, bu yöntem kullanılamaz UseInternalServiceProvider(IServiceProvider) . Bu durumda, bu IMemoryCache hizmet sağlayıcısında doğrudan yapılandırılmalıdır.

Bağlam için kullanılacak modeli ayarlar. Model ayarlandıysa, daha sonra OnModelCreating(ModelBuilder) çalıştırılmaz.

Dışarıdan oluşturulan bir modelin ayarlanması FinalizeModel() ilk olarak çağrılmalıdır.

Bağlamda çalıştırılan LINQ sorgularının izleme davranışını ayarlar. 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() .

Bu yöntem, bu seçeneklerle oluşturulan tüm bağlamların varsayılan davranışını ayarlar, ancak QueryTrackingBehavior ve yöntemlerini kullanarak tek tek sorguları kullanarak bir bağlam örneği için bu davranışı geçersiz kılabilirsiniz AsNoTracking<TEntity>(IQueryable<TEntity>) AsTracking<TEntity>(IQueryable<TEntity>) .

TrackAll varsayılan değerdir. Bu, değişiklik İzleyicisi 'nin bir LINQ sorgusundan döndürülen tüm varlıklar için değişiklikleri tutacağı anlamına gelir.

Verilen uzantıyı seçeneklere ekler. Aynı türde varolan bir uzantı zaten varsa, bu, değişir.

Bu yöntem, bağlamı yapılandırmak için uzantı yöntemleri tarafından kullanılmak üzere tasarlanmıştır. Uygulama kodunda kullanılması amaçlanmamaktadır.

Bir Azure Cosmos veritabanına bağlanmak için bağlamını yapılandırır.

Bir Azure Cosmos veritabanına bağlanmak için bağlamını yapılandırır.

İçeriği, eski paylaşılan bellek içi veritabanına bağlanacak şekilde yapılandırır. Bu yöntem artık kullanılmıyor. Bunun yerine UseInMemoryDatabase(DbContextOptionsBuilder, String, Action<InMemoryDbContextOptionsBuilder>) kullanın.

Adlandırılmış bellek veritabanına bağlanmak için bağlamını yapılandırır. Bellek içi veritabanı aynı adın kullanıldığı her yerde paylaşılır, ancak yalnızca belirli bir hizmet sağlayıcısı için kullanılır.

Adlandırılmış bellek veritabanına bağlanmak için bağlamını yapılandırır. Bellek içi veritabanı aynı adın kullanıldığı her yerde paylaşılır, ancak yalnızca belirli bir hizmet sağlayıcısı için kullanılır. Hizmet sağlayıcıları genelinde aynı bellek içi veritabanını kullanmak için çağrısı yapın UseInMemoryDatabase(DbContextOptionsBuilder, String, InMemoryDatabaseRoot, Action<InMemoryDbContextOptionsBuilder>) InMemoryDatabaseRootveritabanını köke bağlayan paylaşılan bir iletme.

Değişiklik izleme proxy 'lerinin oluşturulmasını etkinleştirir.

Bunun, EF iç hizmet sağlayıcısında uygun hizmetlerin kullanılabilir olmasını gerektirdiğini unutmayın. Normalde bu otomatik olarak gerçekleşir, ancak uygulama hizmet sağlayıcısını denetlikiyorsa, için bir çağrı AddEntityFrameworkProxies(IServiceCollection) gerekebilir.

, Yavaş yükleme proxy 'lerinin oluşturulmasını etkinleştirir.

Bunun, EF iç hizmet sağlayıcısında uygun hizmetlerin kullanılabilir olmasını gerektirdiğini unutmayın. Normalde bu otomatik olarak gerçekleşir, ancak uygulama hizmet sağlayıcısını denetlikiyorsa, için bir çağrı AddEntityFrameworkProxies(IServiceCollection) gerekebilir.

Bir SQLite veritabanına bağlanmak için bağlam yapılandırır, ancak başlangıçta herhangi bir DbConnection veya bağlantı dizesi Ayarlamasız.

Bir veritabanına bağlanmak için kullanılmadan önce bağlantı veya bağlantı dizesinin ayarlanması gerekir DbContext . Kullanarak bir bağlantı ayarlayın SetDbConnection(DatabaseFacade, DbConnection) . Kullanarak bir bağlantı dizesi ayarlayın SetConnectionString(DatabaseFacade, String) .

Bir SQLite veritabanına bağlanmak için bağlamını yapılandırır.

Bir SQLite veritabanına bağlanmak için bağlamını yapılandırır.

, Bir Microsoft SQL Server veritabanına bağlanmak için bağlam yapılandırır, ancak başlangıçta herhangi bir DbConnection veya bağlantı dizesi Ayarlamasız.

Bir veritabanına bağlanmak için kullanılmadan önce bağlantı veya bağlantı dizesinin ayarlanması gerekir DbContext . Kullanarak bir bağlantı ayarlayın SetDbConnection(DatabaseFacade, DbConnection) . Kullanarak bir bağlantı dizesi ayarlayın SetConnectionString(DatabaseFacade, String) .

Microsoft SQL Server bir veritabanına bağlanmak için bağlamını yapılandırır.

Microsoft SQL Server bir veritabanına bağlanmak için bağlamını yapılandırır.