你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CosmosClientOptions.ApplicationRegion 属性

定义

命名空间:

Microsoft.Azure.Cosmos

程序集:

Microsoft.Azure.Cosmos.Client.dll

包:

Microsoft.Azure.Cosmos v3.39.0

Source:

CosmosClientOptions.cs

获取或设置应用程序运行的位置。 这将影响 SDK 对 Azure Cosmos DB 服务交互的选择。

public string ApplicationRegion { get; set; }

member this.ApplicationRegion : string with get, set

Public Property ApplicationRegion As String

属性值

String

示例

如果帐户配置了多个区域（包括美国西部、美国东部和欧洲西部），则配置客户端（如以下示例所示）将导致 CosmosClient 根据与美国东部的邻近程度生成排序的首选区域。 CosmosClient 将向美国东部发送请求，如果该区域不可用，它将回退到美国西部 () 附近的第二位，最后回退到西欧（如果美国西部不可用）。

CosmosClientOptions clientOptions = new CosmosClientOptions()
{
    ApplicationRegion = Regions.EastUS
};

CosmosClient client = new CosmosClient("endpoint", "key", clientOptions);

注解

在 CosmosClient 初始化期间，帐户信息（包括可用区域）从 Endpoint获取。 CosmosClient 将使用 的值 ApplicationRegion 填充首选列表，其中包含按与指定区域的地理邻近程度排序的帐户可用区域。 如果 的值 ApplicationRegion 不是帐户中的可用区域，则仍会按照相同的机制填充首选列表，但不包括指示的区域。

如果在 CosmosClient 初始化 Endpoint 期间无法访问 ，则 CosmosClient 将尝试恢复并获取帐户信息，该帐户信息会向所有 Regions 排序者发出请求，方法是靠近 ApplicationRegion。 若要更精细地控制所选区域或根据自定义条件定义列表，请使用 ApplicationPreferredRegions 而不是 ApplicationRegion。

有关更多详细信息，另请参阅 诊断和排查 Cosmos SDK 的可用性 问题。

此配置是 的替代方法 ApplicationPreferredRegions，可以设置任一配置，但不能同时设置两者。

另请参阅

• WithApplicationRegion(String)