DbContextOptionsBuilder<TContext> 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.
yapılandırması DbContextOptions<TContext>için basit bir API yüzeyi sağlar. Veritabanları (ve diğer uzantılar) genellikle bu nesnede bir bağlam için kullanılacak veritabanı bağlantısını (ve diğer seçenekleri) yapılandırmanıza olanak sağlayan uzantı yöntemlerini tanımlar.
public class DbContextOptionsBuilder<TContext> : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder where TContext : DbContexttype DbContextOptionsBuilder<'Context (requires 'Context :> DbContext)> = class
inherit DbContextOptionsBuilderPublic Class DbContextOptionsBuilder(Of TContext)
Inherits DbContextOptionsBuilderTür Parametreleri
- TContext
Yapılandırılacak bağlam türü.
- Devralma
Açıklamalar
Bir bağlamı geçersiz kılarak OnConfiguring(DbContextOptionsBuilder) veya harici olarak DbContextOptions oluşturup bağlam oluşturucuya geçirerek yapılandırmak için kullanabilirsinizDbContextOptionsBuilder.
Daha fazla bilgi ve örnek için bkz. DbContextOptions kullanma .
Oluşturucular
| DbContextOptionsBuilder<TContext>() |
Hiçbir seçenek ayarlı olmadan sınıfının yeni bir örneğini DbContextOptionsBuilder<TContext> başlatır. |
| DbContextOptionsBuilder<TContext>(DbContextOptions<TContext>) |
Belirli DbContextOptionsbir öğesini daha fazla yapılandırmak için sınıfının yeni bir örneğini DbContextOptionsBuilder<TContext> başlatır. |
Özellikler
| IsConfigured |
Herhangi bir seçeneğin yapılandırılıp yapılandırılmadığını belirten bir değer alır. (Devralındığı yer: DbContextOptionsBuilder) |
| Options |
Yapılandırılan seçenekleri alır. |
Yöntemler
| AddInterceptors(IEnumerable<IInterceptor>) |
Bağlama kaydedilenlere örnekler ekler IInterceptor . |
| AddInterceptors(IEnumerable<IInterceptor>) |
Bağlama kaydedilenlere örnekler ekler IInterceptor . (Devralındığı yer: DbContextOptionsBuilder) |
| AddInterceptors(IInterceptor[]) |
Bağlama kaydedilenlere örnekler ekler IInterceptor . |
| AddInterceptors(IInterceptor[]) |
Bağlama kaydedilenlere örnekler ekler IInterceptor . (Devralındığı yer: DbContextOptionsBuilder) |
| ConfigureLoggingCacheTime(TimeSpan) |
EF Core'un belirli yüksek performanslı yollarda günlüğe kaydetme yapılandırmasını ne kadar süreyle önbelleğe alacağını yapılandırır. Bu, EF Core'un olası maliyetli günlük denetimlerini atlar, ancak çalışma zamanı günlüğü değişikliklerinin (örneğin, yeni DiagnosticListener bir kaydın hemen hesaba katılmayabileceği) anlamına gelir. |
| ConfigureLoggingCacheTime(TimeSpan) |
EF Core'un belirli yüksek performanslı yollarda günlüğe kaydetme yapılandırmasını ne kadar süreyle önbelleğe alacağını yapılandırır. Bu, EF Core'un olası maliyetli günlük denetimlerini atlar, ancak çalışma zamanı günlüğü değişikliklerinin (örneğin, yeni DiagnosticListener bir kaydın hemen hesaba katılmayabileceği) anlamına gelir. (Devralındığı yer: DbContextOptionsBuilder) |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Entity Framework tarafından oluşturulan uyarıların çalışma zamanı davranışını yapılandırılır. Her uyarı türü için varsayılan davranış ve davranışlar ayarlayabilirsiniz. |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Entity Framework tarafından oluşturulan uyarıların çalışma zamanı davranışını yapılandırılır. Her uyarı türü için varsayılan davranış ve davranışlar ayarlayabilirsiniz. |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Entity Framework tarafından oluşturulan uyarıların çalışma zamanı davranışını yapılandırılır. Her uyarı türü için varsayılan davranış ve davranışlar ayarlayabilirsiniz. (Devralındığı yer: DbContextOptionsBuilder) |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Entity Framework tarafından oluşturulan uyarıların çalışma zamanı davranışını yapılandırılır. Her uyarı türü için varsayılan davranış ve davranışlar ayarlayabilirsiniz. (Devralındığı yer: DbContextOptionsBuilder) |
| EnableDetailedErrors(Boolean) |
Depolama sorgusu sonuçlarının işlenmesi sırasında oluşan veri değeri özel durumlarını işlerken ayrıntılı hataları etkinleştirir. 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ılmışsa ancak depodaki temel alınan veriler aslında 'dize' türündeyse, veri değeri işlenirken çalışma zamanında bir özel durum oluşturulur. Bu seçenek etkinleştirildiğinde ve bir veri hatasıyla karşılaşıldığında, oluşturulan özel durum hatayı oluşturan belirli varlık özelliğinin ayrıntılarını içerir. |
| EnableDetailedErrors(Boolean) |
Depolama sorgusu sonuçlarının işlenmesi sırasında oluşan veri değeri özel durumlarını işlerken ayrıntılı hataları etkinleştirir. 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ılmışsa ancak depodaki temel alınan veriler aslında 'dize' türündeyse, veri değeri işlenirken çalışma zamanında bir özel durum oluşturulur. Bu seçenek etkinleştirildiğinde ve bir veri hatasıyla karşılaşıldığında, oluşturulan özel durum hatayı oluşturan belirli varlık özelliğinin ayrıntılarını içerir. (Devralındığı yer: DbContextOptionsBuilder) |
| EnableSensitiveDataLogging() |
Uygulama verilerinin özel durum iletilerine, günlüğe kaydetmeye vb. eklenmesini sağlar. Bu, varlık örneklerinizin özelliklerine atanan değerleri, veritabanına gönderilen komutların parametre değerlerini ve bu tür diğer verileri içerebilir. Bu bayrağı yalnızca bu verilerin duyarlılığına bağlı olarak uygun güvenlik önlemlerine sahipseniz etkinleştirmeniz gerekir. |
| EnableSensitiveDataLogging() |
Uygulama verilerinin özel durum iletilerine, günlüğe kaydetmeye vb. eklenmesini sağlar. Bu, varlık örneklerinizin özelliklerine atanan değerleri, veritabanına gönderilen komutların parametre değerlerini ve bu tür diğer verileri içerebilir. Bu bayrağı yalnızca bu verilerin duyarlılığına bağlı olarak uygun güvenlik önlemlerine sahipseniz etkinleştirmeniz gerekir. (Devralındığı yer: DbContextOptionsBuilder) |
| EnableSensitiveDataLogging(Boolean) |
Uygulama verilerinin özel durum iletilerine, günlüğe kaydetmeye vb. eklenmesini sağlar. Bu, varlık örneklerinizin özelliklerine atanan değerleri, veritabanına gönderilen komutların parametre değerlerini ve bu tür diğer verileri içerebilir. Bu bayrağı yalnızca bu verilerin duyarlılığına bağlı olarak uygun güvenlik önlemlerine sahipseniz etkinleştirmeniz gerekir. |
| EnableSensitiveDataLogging(Boolean) |
Uygulama verilerinin özel durum iletilerine, günlüğe kaydetmeye vb. eklenmesini sağlar. Bu, varlık örneklerinizin özelliklerine atanan değerleri, veritabanına gönderilen komutların parametre değerlerini ve bu tür diğer verileri içerebilir. Bu bayrağı yalnızca bu verilerin duyarlılığına bağlı olarak uygun güvenlik önlemlerine sahipseniz etkinleştirmeniz gerekir. (Devralındığı yer: DbContextOptionsBuilder) |
| EnableServiceProviderCaching(Boolean) |
İç hizmet sağlayıcılarının önbelleğe alınmasını etkinleştirir veya devre dışı bırakır. Önbelleğe almayı devre dışı bırakmak performansı 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. |
| EnableServiceProviderCaching(Boolean) |
İç hizmet sağlayıcılarının önbelleğe alınmasını etkinleştirir veya devre dışı bırakır. Önbelleğe almayı devre dışı bırakmak performansı 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. (Devralındığı yer: DbContextOptionsBuilder) |
| EnableThreadSafetyChecks(Boolean) |
Eşzamanlılık algılamasını devre dışı bırakır. Bu durum, bir DbContext örneğin hatalı eş zamanlı kullanımıyla ilgili birçok durumu algılar ve bilgilendirici bir özel durumun oluşmasına neden olur. Bu küçük bir performans geliştirmesi sağlar, ancak bir DbContext örnek eşzamanlı olarak kullanılırsa, davranış tanımsız olur ve program öngörülemeyen yollarla başarısız olabilir. |
| EnableThreadSafetyChecks(Boolean) |
Eşzamanlılık algılamasını devre dışı bırakır. Bu durum, bir DbContext örneğin hatalı eş zamanlı kullanımıyla ilgili birçok durumu algılar ve bilgilendirici bir özel durumun oluşmasına neden olur. Bu küçük bir performans geliştirmesi sağlar, ancak bir DbContext örnek eşzamanlı olarak kullanılırsa, davranış tanımsız olur ve program öngörülemeyen yollarla başarısız olabilir. (Devralındığı yer: DbContextOptionsBuilder) |
| LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>) |
Sağlanan özel filtre temsilcisi tarafından filtrelenen olayları günlüğe kaydeder. Filtre, bir iletiyi günlüğe kaydetmek için true veya günlüğün dışında filtrelemek için false döndürmelidir. |
| LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>) |
Sağlanan özel filtre temsilcisi tarafından filtrelenen olayları günlüğe kaydeder. Filtre, bir iletiyi günlüğe kaydetmek için true veya günlüğün dışında filtrelemek için false döndürmelidir. (Devralındığı yer: DbContextOptionsBuilder) |
| LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) |
Sağlanan eylemi kullanarak belirtilen olayları günlüğe kaydeder. Örneğin, konsolda ContextInitialized olayı günlüğe kaydetmek için kullanın |
| LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) |
Sağlanan eylemi kullanarak belirtilen olayları günlüğe kaydeder. Örneğin, konsolda ContextInitialized olayı günlüğe kaydetmek için kullanın |
| LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Sağlanan eylemi kullanarak belirtilen kategorilerdeki tüm olayları günlüğe kaydeder. Örneğin, kategorideki DbLoggerCategory.Infrastructure tüm olayları günlüğe kaydetmek için kullanın |
| LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Sağlanan eylemi kullanarak belirtilen kategorilerdeki tüm olayları günlüğe kaydeder. Örneğin, kategorideki DbLoggerCategory.Infrastructure tüm olayları günlüğe kaydetmek için kullanın |
| LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Sağlanan eylemi kullanarak günlüğe kaydeder. Örneğin, konsolda oturum açmak için kullanın |
| LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Sağlanan eylemi kullanarak günlüğe kaydeder. Örneğin, konsolda oturum açmak için kullanın |
| LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>) |
Olayları özel bir filtre temsilcisi tarafından filtrelenmiş özel bir günlükçü temsilcisine günlüğe kaydeder. Filtre, bir iletiyi günlüğe kaydetmek için true veya günlüğün dışında filtrelemek için false döndürmelidir. |
| LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>) |
Olayları özel bir filtre temsilcisi tarafından filtrelenmiş özel bir günlükçü temsilcisine günlüğe kaydeder. Filtre, bir iletiyi günlüğe kaydetmek için true veya günlüğün dışında filtrelemek için false döndürmelidir. (Devralındığı yer: DbContextOptionsBuilder) |
| ReplaceService<TService,TCurrentImplementation,TNewImplementation>() |
Hizmet sözleşmesinin belirli bir uygulamasının iç Entity Framework uygulamasını farklı bir uygulamayla değiştirir. |
| ReplaceService<TService,TCurrentImplementation,TNewImplementation>() |
Hizmet sözleşmesinin belirli bir uygulamasının iç Entity Framework uygulamasını farklı bir uygulamayla değiştirir. (Devralındığı yer: DbContextOptionsBuilder) |
| ReplaceService<TService,TImplementation>() |
Bir hizmet sözleşmesinin tüm iç Entity Framework uygulamalarını farklı bir uygulamayla değiştirir. |
| ReplaceService<TService,TImplementation>() |
Bir hizmet sözleşmesinin tüm iç Entity Framework uygulamalarını farklı bir uygulamayla değiştirir. (Devralındığı yer: DbContextOptionsBuilder) |
| UseApplicationServiceProvider(IServiceProvider) |
Uygulama hizmetlerinin IServiceProvider hangi kaynaktan alınacağını ayarlar. Bu, 'AddDbContext' kullanılırken otomatik olarak yapılır, bu nedenle bu yöntemin çağrılması çok nadirdir. |
| UseApplicationServiceProvider(IServiceProvider) |
Uygulama hizmetlerinin IServiceProvider hangi kaynaktan alınacağını ayarlar. Bu, 'AddDbContext' veya 'AddDbContextPool' kullanılırken otomatik olarak yapılır, bu nedenle bu yöntemin çağrılması çok nadirdir. (Devralındığı yer: DbContextOptionsBuilder) |
| UseInternalServiceProvider(IServiceProvider) |
Bağlamın IServiceProvider tüm hizmetlerini çözümlemesi gereken öğesini ayarlar. Ef, belirtilmemişse bir hizmet sağlayıcısı oluşturur ve yönetir. |
| UseLoggerFactory(ILoggerFactory) |
Bu bağlam tarafından ILoggerFactory yapılan günlüğe kaydetme örnekleri oluşturmak ILogger için kullanılacak öğesini ayarlar. |
| UseMemoryCache(IMemoryCache) |
IMemoryCache Bu bağlama göre sorgu önbelleğe alma için kullanılacak öğesini ayarlar. |
| UseModel(IModel) |
Bağlam için kullanılacak modeli ayarlar. Model ayarlandıysa OnModelCreating(ModelBuilder) çalıştırılmaz. |
| UseQueryTrackingBehavior(QueryTrackingBehavior) |
Bağlama göre çalıştırılacak LINQ sorguları için izleme davranışını ayarlar. Değişiklik izlemenin devre dışı bırakılması, her varlık örneği için değişiklik izleme ayarlama ek yükünü önlediğinden salt okunur senaryolar için kullanışlıdır. Varlık örneklerini işlemek ve bu değişiklikleri kullanarak SaveChanges()veritabanında kalıcı hale getirmek istiyorsanız değişiklik izlemeyi devre dışı bırakmamalısınız. |
| UseQueryTrackingBehavior(QueryTrackingBehavior) |
Bağlama göre çalıştırılacak LINQ sorguları için izleme davranışını ayarlar. Değişiklik izlemenin devre dışı bırakılması, her varlık örneği için değişiklik izleme ayarlama ek yükünü önlediğinden salt okunur senaryolar için kullanışlıdır. Varlık örneklerini işlemek ve kullanarak SaveChanges()bu değişiklikleri veritabanında kalıcı hale getirmek istiyorsanız değişiklik izlemeyi devre dışı bırakmamalısınız. (Devralındığı yer: DbContextOptionsBuilder) |
| UseRootApplicationServiceProvider() |
Kapsamı belirlenmiş uygulama hizmeti sağlayıcısından kökünü IServiceProvider çözümler. Kök sağlayıcı, tekil iç hizmetlerden tekil uygulama hizmetleri almak için kullanılabilir. |
| UseRootApplicationServiceProvider() |
Kapsamı belirlenmiş uygulama hizmet sağlayıcısından kökünü IServiceProvider çözümler. Kök sağlayıcı, tekil iç hizmetlerden tekil uygulama hizmetlerini almak için kullanılabilir. (Devralındığı yer: DbContextOptionsBuilder) |
| UseRootApplicationServiceProvider(IServiceProvider) |
Tekil uygulama hizmetlerinin tekil iç hizmetlerden alınabileceği kökü IServiceProvider ayarlar. |
| UseRootApplicationServiceProvider(IServiceProvider) |
Tekil uygulama hizmetlerinin tekil iç hizmetlerden alınabileceği kökü IServiceProvider ayarlar. (Devralındığı yer: DbContextOptionsBuilder) |
Belirtik Arabirim Kullanımları
| IDbContextOptionsBuilderInfrastructure.AddOrUpdateExtension<TExtension>(TExtension) |
Verilen uzantıyı seçeneklere ekler. Aynı türde mevcut bir uzantı zaten varsa, bu uzantı değiştirilir. (Devralındığı yer: DbContextOptionsBuilder) |
Uzantı Metotları
Şunlara uygulanır
Entity Framework