Dil

CosmosDbContextOptionsBuilder Sınıf

Tanım

Cosmos'a özgü yapılandırmanın üzerinde DbContextOptionsgerçekleştirilmesini sağlar.

[System.Runtime.CompilerServices.Nullable(0)]
public class CosmosDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.ICosmosDbContextOptionsBuilderInfrastructure
public class CosmosDbContextOptionsBuilder
public class CosmosDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.ICosmosDbContextOptionsBuilderInfrastructure
[<System.Runtime.CompilerServices.Nullable(0)>]
type CosmosDbContextOptionsBuilder = class
    interface ICosmosDbContextOptionsBuilderInfrastructure
type CosmosDbContextOptionsBuilder = class
type CosmosDbContextOptionsBuilder = class
    interface ICosmosDbContextOptionsBuilderInfrastructure
Public Class CosmosDbContextOptionsBuilder
Implements ICosmosDbContextOptionsBuilderInfrastructure
Public Class CosmosDbContextOptionsBuilder
Devralma
CosmosDbContextOptionsBuilder
Özellikler
Uygulamalar

Açıklamalar

Bu sınıfın örnekleri çağrısından CosmosDbContextOptionsExtensions.UseCosmos{TContext} döndürülür ve uygulama kodunuzda doğrudan oluşturulacak şekilde tasarlanmamıştır.

Daha fazla bilgi ve örnek için bkz. DbContextOptions kullanma ve EF Core ile Azure Cosmos DB erişme.

Oluşturucular

Veri Akışı Adı Description
CosmosDbContextOptionsBuilder(DbContextOptionsBuilder)

CosmosDbContextOptionsBuilder sınıfının yeni bir örneğini başlatır.

Yöntemler

Veri Akışı Adı Description
BulkExecutionAllowed(Boolean)

Cosmos DB SDK toplu yürütme özelliğini etkinleştirmek için boole değerini ayarlar. Bu özelliğin etkinleştirilmesi küçük yazma işlemleri için aktarım hızını artırabilir ancak gecikme süresini artırabilir. Yalnızca yüksek aktarım hızı, gecikme süresine duyarlı olmayan senaryolar için önerilir. İşlem Toplu İşlemleri toplu modda yürütülemediğinden, EF tarafından toplu olarak yapılan işlemler toplu yürütmeyi kullanmaz. İşlemlerin toplu olarak yürütülmesini sağlamak için ayarını Neveryaparak toplu işlemi devre dışı bırakmayı göz önünde bulundurun. Daha fazla bilgi için bkz. Veri Kaydetme - Azure Cosmos DB Sağlayıcı.

ConnectionMode(ConnectionMode)

Bağlamı sağlanan bağlantı modunu kullanacak şekilde yapılandırılır.

ContentResponseOnWriteEnabled(Boolean)
Geçersiz.

Boole değerini yalnızca Create, Upsert, Patch ve Replace gibi yazma öğesi işlemi için Cosmos DB yanıtında üst bilgileri ve durum kodunu döndürecek şekilde ayarlar. seçeneğinin false olarak ayarlanması, yanıtın boş bir kaynağa sahip olmasına neden olur. Bu, kaynağı ağ üzerinden geri göndermeyerek ve istemcide seri hale getirerek ağ ve CPU yükünü azaltır.

ExecutionStrategy(Func<ExecutionStrategyDependencies,IExecutionStrategy>)

Bağlamı sağlanan öğesini kullanacak şekilde yapılandırıyor IExecutionStrategy.

GatewayModeMaxConnectionLimit(Int32)

Azure Cosmos DB hizmetinde hedef hizmet uç noktası için izin verilen en fazla eşzamanlı bağlantı sayısını yapılandırılır.

HttpClientFactory(Func<HttpClient>)

Bağlamı belirli HttpClient bir fabrikayı kullanacak şekilde yapılandırılır.

IdleTcpConnectionTimeout(TimeSpan)

Kullanılmayan bağlantıların kapatıldığı boşta kalma süresini yapılandırır.

LimitToEndpoint(Boolean)

İşlemleri sağlanan uç noktayla sınırlar.

MaxRequestsPerTcpConnection(Int32)

Tek bir TCP bağlantısı üzerinden aynı anda izin verilen istek sayısını yapılandırılır. Aynı anda daha fazla istek olduğunda, doğrudan/TCP istemcisi ek bağlantılar açar.

MaxTcpConnectionsPerEndpoint(Int32)

Her Cosmos DB arka ucuna açılabilir en fazla TCP bağlantısı sayısını yapılandırılır. MaxRequestsPerTcpConnection ile birlikte, bu ayar aynı anda tek bir Cosmos DB arka ucuna gönderilen istek sayısını sınırlar (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint).

OpenTcpConnectionTimeout(TimeSpan)

Bağlantı kurmaya çalışmak için izin verilen süreyi yapılandırılır.

PreferredRegions(IReadOnlyList<String>)

Coğrafi olarak çoğaltılan veritabanı hesapları için sağlanan tercih edilen bölgeleri kullanmak üzere bağlamı yapılandırılır.

Region(String)

Bağlamı sağlanan coğrafi olarak çoğaltılan bölgeyi kullanacak şekilde yapılandırılır.

RequestTimeout(TimeSpan)

Azure Cosmos DB hizmetine bağlanırken zaman aşımını yapılandırıyor. Sayı, yanıtın ağ eşlerinden geri gelmesini bekleme süresini belirtir.

SessionTokenManagementMode(SessionTokenManagementMode)

Kullanılacak öğesini SessionTokenManagementMode ayarlar. Varsayılan olarak FullyAutomatic kullanılır. Diğer modlar yalnızca uygulamanızın oturum belirteçlerini el ile yönetmesi gerektiğinde geçerlidir. Örneğin: İstekler arasında oturum benzitesini korumayan hepsini bir kez deneme yük dengeleyici kullanıyorsanız. El ile oturum belirteci yönetimi düzgün şekilde işlenmediğinde oturum tutarlılığını bozabilir. Bkz. Oturum belirteçlerini kullanma daha fazla ayrıntı için.

WebProxy(IWebProxy)

Web istekleri için kullanılan ara sunucu bilgilerini yapılandırılır.

WithOption(Func<CosmosOptionsExtension,CosmosOptionsExtension>)

Ayarları depolamak için kullanılan uzantıyı kopyalayarak bir seçenek ayarlar. Bu, oluşturucunun başka bir yerde zaten kullanımda olan seçenekleri değiştirmemesini sağlar.

Belirtik Arabirim Kullanımları

Veri Akışı Adı Description
ICosmosDbContextOptionsBuilderInfrastructure.OptionsBuilder

Temel seçenekler oluşturucusunu alır.

Şunlara uygulanır