System.Globalization.CultureAndRegionInfoBuilder 构造函数

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

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

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

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

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

通过调用CultureAndRegionInfoBuilderLoadDataFromCultureInfo方法,将区域性和国家/地区信息填充到新LoadDataFromRegionInfo对象中。

自定义文化名称

新自定义区域的cultureName参数的首选格式为“[prefix-]language[-region][-suffix[]]”,其中language组件是必需的,而prefixregionsuffix组件是可选的。 每个组件的最大长度为 8 个字符,整个 cultureName 参数的最大长度为 84 个字符。

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

参数 language 的组件指定一个由 ISO 639-1 派生的小写双字母代码,而 cultureName 指定一个由 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 组件。