CultureInfo.GetCultureInfoByIetfLanguageTag(String) 方法

定义

命名空间:

System.Globalization

程序集:

System.Runtime.dll

Source:

CultureInfo.cs

已弃用。 检索只读的 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

只读 CultureInfo 对象。

例外

ArgumentNullException

name 为 null。

CultureNotFoundException

name 与支持的区域性不对应。

注解

注意

此方法和 IetfLanguageTag 属性已弃用。 建议使用CultureInfo构造函数 、 和 Name 属性，CultureInfo.GetCultureInfo而不是使用这些 API。 IETF 标记和名称相同。

由 Internet 工程任务组维护的 RFC 4646 标准 (IETF) 定义了一个 IETF 语言标记，该标记提供了一种统一的标识语言的方法。 IETF 语言标记的格式与 属性返回 Name 的区域性名称相同，但不唯一标识区域性。 如果不同区域性具有相同的语言特征，则这些区域性共享相同的 IETF 语言标记。 区域性的语言特征包含在与 CultureInfo 对象关联的 对象中TextInfo。

IETF 语言标记由必需语言标识符、可选脚本标识符和可选区域标识符组成。

应用程序应使用检索到的区域性来控制特定于语言的任务，例如管理拼写或语法检查器。 应用程序不应使用检索到的区域性来控制特定于区域性的任务，例如对文本进行排序或设置时间和日期格式。

有关详细信息，请参阅 RFC 4646 - “标识语言的标记。

调用方说明

.NET Framework 3.5 及更早版本如果name与支持区域性的名称不对应，则会引发 ArgumentException 。 从 .NET Framework 4 开始，此方法将CultureNotFoundException引发 。

另请参阅

• TextInfo
• CultureAndRegionInfoBuilder
• ClearCachedData()