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 属性已弃用。 建议使用 CultureInfo 构造函数、 CultureInfo.GetCultureInfo 和属性,而不是使用这些 api Name 。 IETF 标记和名称是相同的。
Internet 工程任务组 (IETF) 所维护的 RFC 4646 标准定义了一个 IETF 语言标记,该标记提供了一种统一的方式来识别语言。 IETF 语言标记的格式与属性返回的区域性名称相同 Name ,但不会唯一标识区域性。 如果不同的区域性具有相同的语言特征,则它们共享相同的 IETF 语言标记。 区域性的语言特征包含在 TextInfo 与对象关联的对象中 CultureInfo 。
IETF 语言标记由必需的语言标识符、可选脚本标识符和可选区域标识符组成。
您的应用程序应使用检索到的区域性来控制特定于语言的任务,例如管理拼写或语法检查程序。 应用程序不应使用检索到的区域性来控制区域性特定的任务,例如对文本或格式设置时间和日期进行排序。
有关详细信息,请参阅 RFC 4646-用于标识语言的标记。
调用方说明
.NET Framework 3.5 及更早版本在 ArgumentException 与 name
受支持的区域性的名称不对应时引发。 从 .NET Framework 4 开始,此方法将引发 CultureNotFoundException 。