CosmosDbContextOptionsBuilder Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite realizar una configuración específica de Cosmos en DbContextOptions.
[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
- Herencia
-
CosmosDbContextOptionsBuilder
- Atributos
- Implementaciones
Comentarios
Las instancias de esta clase se devuelven desde una llamada a CosmosDbContextOptionsExtensions.UseCosmos{TContext} y no está diseñada para construirse directamente en el código de la aplicación.
Consulte Uso de DbContextOptions y Acceso a Azure Cosmos DB con EF Core para obtener más información y ejemplos.
Constructores
| Nombre | Description |
|---|---|
| CosmosDbContextOptionsBuilder(DbContextOptionsBuilder) |
Inicializa una nueva instancia de la clase CosmosDbContextOptionsBuilder. |
Métodos
| Nombre | Description |
|---|---|
| BulkExecutionAllowed(Boolean) |
Establece el valor booleano para habilitar la característica de ejecución masiva del SDK de Cosmos DB. La habilitación de esta característica puede mejorar el rendimiento de las operaciones de escritura pequeñas, pero puede aumentar la latencia. Solo se recomienda para escenarios de alto rendimiento y no sensibles a la latencia. Dado que los lotes transaccionales no se pueden ejecutar en modo masivo, las operaciones por lotes por lotes por ef no usarán la ejecución masiva. Para asegurarse de que las operaciones se ejecutan en masa, considere la posibilidad de deshabilitar el procesamiento por lotes estableciendo Never. Para obtener más información, vea Guardar datos: proveedor de Azure Cosmos DB. |
| ConnectionMode(ConnectionMode) |
Configura el contexto para usar el modo de conexión proporcionado. |
| ContentResponseOnWriteEnabled(Boolean) |
Obsoletos.
Establece el valor booleano para que solo devuelva los encabezados y el código de estado en la respuesta de Cosmos DB para la operación de elemento de escritura, como Create, Upsert, Patch y Replace. Si se establece la opción en false, la respuesta tendrá un recurso NULL. Esto reduce la carga de red y CPU al no enviar el recurso a través de la red y serializarlo en el cliente. |
| ExecutionStrategy(Func<ExecutionStrategyDependencies,IExecutionStrategy>) |
Configura el contexto para usar el proporcionado IExecutionStrategy. |
| GatewayModeMaxConnectionLimit(Int32) |
Configura el número máximo de conexiones simultáneas permitidas para el punto de conexión de servicio de destino en el servicio Azure Cosmos DB. |
| HttpClientFactory(Func<HttpClient>) |
Configura el contexto para usar un generador específico HttpClient . |
| IdleTcpConnectionTimeout(TimeSpan) |
Configura la cantidad de tiempo de inactividad después de la cual se cierran las conexiones sin usar. |
| LimitToEndpoint(Boolean) |
Limita las operaciones al punto de conexión proporcionado. |
| MaxRequestsPerTcpConnection(Int32) |
Configura el número de solicitudes permitidas simultáneamente a través de una única conexión TCP. Cuando hay más solicitudes en curso simultáneamente, el cliente direct/TCP abrirá conexiones adicionales. |
| MaxTcpConnectionsPerEndpoint(Int32) |
Configura el número máximo de conexiones TCP que se pueden abrir en cada back-end de Cosmos DB. Junto con MaxRequestsPerTcpConnection, esta configuración limita el número de solicitudes que se envían simultáneamente a un único back-end de Cosmos DB (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint). |
| OpenTcpConnectionTimeout(TimeSpan) |
Configura la cantidad de tiempo permitido para intentar establecer una conexión. |
| PreferredRegions(IReadOnlyList<String>) |
Configura el contexto para usar las regiones preferidas proporcionadas para las cuentas de base de datos con replicación geográfica. |
| Region(String) |
Configura el contexto para usar la región con replicación geográfica proporcionada. |
| RequestTimeout(TimeSpan) |
Configura el tiempo de espera al conectarse al servicio Azure Cosmos DB. El número especifica el tiempo de espera para que la respuesta vuelva del mismo nivel de red. |
| SessionTokenManagementMode(SessionTokenManagementMode) |
Establece el objeto SessionTokenManagementMode que se va a usar. De forma predeterminada, FullyAutomatic se usará. Cualquier otro modo solo es relevante cuando la aplicación necesita administrar los tokens de sesión manualmente. Por ejemplo: si usa un equilibrador de carga round robin que no mantiene la afinidad de sesión entre las solicitudes. La administración manual de tokens de sesión puede interrumpir la coherencia de la sesión cuando no se controla correctamente. Vea . Uso de tokens de sesión para obtener más información. |
| WebProxy(IWebProxy) |
Configura la información de proxy utilizada para las solicitudes web. |
| WithOption(Func<CosmosOptionsExtension,CosmosOptionsExtension>) |
Establece una opción mediante la clonación de la extensión utilizada para almacenar la configuración. Esto garantiza que el generador no modifique las opciones que ya están en uso en otro lugar. |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| ICosmosDbContextOptionsBuilderInfrastructure.OptionsBuilder |
Obtiene el generador de opciones principales. |