CultureInfo.GetCultureInfoByIetfLanguageTag(String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
已弃用。 检索只读的 CultureInfo 对象,其语言特征由指定的 RFC 4646 语言标记标识。
public:
static System::Globalization::CultureInfo ^ GetCultureInfoByIetfLanguageTag(System::String ^ name);
public static System.Globalization.CultureInfo GetCultureInfoByIetfLanguageTag (string name);
static member GetCultureInfoByIetfLanguageTag : string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfoByIetfLanguageTag (name As String) As CultureInfo
参数
- name
- String
按 RFC 4646 标准指定的语言的名称。
返回
只读 CultureInfo 对象。
例外
name
为 null。
name
与支持的区域性不对应。
注解
备注
此方法和 IetfLanguageTag 属性已弃用。 建议使用构造函数和Name属性,CultureInfo.GetCultureInfo而不是使用这些 CultureInfo API。 IETF 标记和名称相同。
由 Internet 工程工作组 (IETF 维护的 RFC 4646 标准) 定义了 IETF 语言标记,该标记提供了用于标识语言的统一方法。 IETF 语言标记的格式与属性返回 Name 的区域性名称相同,但不唯一标识区域性。 如果这些区域性具有相同的语言特征,则不同的区域性共享相同的 IETF 语言标记。 区域性的语言特征包含在与CultureInfo对象关联的对象中TextInfo。
IETF 语言标记由强制语言标识符、可选脚本标识符和可选区域标识符组成。
应用程序应使用检索到的区域性来控制特定于语言的任务,例如管理拼写或语法检查器。 应用程序不应使用检索到的区域性来控制特定于区域性的任务,例如对文本或格式设置时间和日期进行排序。
有关详细信息,请参阅 RFC 4646 - “用于标识语言的标记。
调用方说明
.NET Framework 3.5 及更早版本引发ArgumentException与受支持的区域性的名称不相对应的值name
。 从 .NET Framework 4 开始,此方法将引发一个 CultureNotFoundException。