System.Globalization.CultureAndRegionInfoBuilder 构造函数

本文提供了此 API 参考文档的补充说明。

本文与 CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) 构造函数相关。

该 cultureName 参数指定新 CultureAndRegionInfoBuilder 对象的名称。

该 flags 参数用于一个 CultureAndRegionModifiers 值，该值指定新对象是新的 CultureAndRegionInfoBuilder 自定义区域性，还是替换现有的中性区域性、特定区域性或 Windows 区域设置。

cultureName如果参数指定现有的 .NET 区域性、注册的自定义区域性或从 Windows 区域设置生成的区域性，则CultureAndRegionInfoBuilder构造函数会自动使用区域性和国家/地区信息填充新CultureAndRegionInfoBuilder对象。

通过调用LoadDataFromCultureInfo和LoadDataFromRegionInfo方法，使用区域性和国家/地区信息填充新CultureAndRegionInfoBuilder对象。

自定义区域性名称

新自定义区域性的参数的首选格式cultureName为“[prefix-]language[-region][-][-…suffix[]]”，其中language需要组件，prefixregion并且组件suffix是可选的。 每个组件的最大长度为 8 个字符，整个 cultureName 参数的最大长度为 84 个字符。

该 prefix 组件是 Internet 分配号码机构 （IANA） 标识。 为注册到 IANA 的区域性名称指定“i-”或“I-”，或者为保留专用使用的区域性名称指定“x-”或“X-”。 否则，不需要前缀。 有关详细信息，请参阅 RFC 4646，“用于语言标识的标记”。

参数 language 的组件指定派生自 ISO 639-1 的小 cultureName 写双字母代码，并 region 指定从 ISO 3166 派生的大写双字母代码。 例如，en-US 代表美国中说的英语。 缺少 region 组件表示非特定区域性。

cultureName与 .NET 附带的区域性的名称相同，表示替换（替代）区域性。 可分配给替换区域性属性的值受到限制。 有关此类限制的详细信息，请参阅每个属性的异常。

应用程序使用 suffix 组件来区分类似的区域性。 例如，两家公司（ABC 和 XYZ）创建并共享新的 ASP.NET Web 服务，以便在世界各地的不同市场中推广其产品。 服务网页显示信息，例如每个公司的区域徽标和本地电话号码，具体取决于用户的区域性。 每个网页的区域性特定内容位于由区域性名称标识并按公司名称限定的独立资源文件中。 例如，en-US 和 ja-JP 区域性的资源文件名为 en-US-ABC、en-US-XYZ、ja-JP-ABC 和 ja-JP-XYZ。 “ABC”和“XYZ”后缀使 Web 服务能够使用相同的应用程序逻辑来显示不同的特定于市场的信息。

该 suffix 组件可以包含子组件，其中每个子组件由连字符分隔，每个子组件的最大长度为 8 个字符。 例如，如果“en-US-honda-cars”是 cultureName 参数，则“-honda-cars”是 suffix 组件。