CultureInfo.GetCultureInfoByIetfLanguageTag(String) 方法

定義

命名空間:

System.Globalization

組件:

System.Runtime.dll

來源:

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.GetCultureInfo和 Name 屬性，而不是使用這些 CultureInfo API。 IETF 標記和名稱完全相同。

Internet Engineering Task Force (IETF 所維護的 RFC 4646 標準) 會定義 IETF 語言標籤，以提供一致的識別語言方式。 IETF 語言標記的格式與 屬性所 Name 傳回的文化特性名稱相同，但無法唯一識別文化特性。 如果這些文化特性具有相同的語言特性，不同的文化特性會共用相同的 IETF 語言標籤。 文化特性的語言特性包含在與 CultureInfo 對象相關聯的物件中TextInfo。

IETF 語言標籤是由強制語言標識碼、選擇性腳本標識碼和選擇性區域識別碼所組成。

您的應用程式應該使用擷取的文化特性來控制語言特定工作，例如管理拼字或文法檢查程式。 應用程式不應該使用擷取的文化特性來控制特定文化特性的工作，例如排序文字或格式化時間和日期。

如需詳細資訊，請參閱 RFC 4646 -「識別語言的標記」。

給呼叫者的注意事項

.NET Framework 3.5 和舊版若name未對應至支援文化特性的名稱，則會擲ArgumentException回 。 從 .NET Framework 4 開始，這個方法會擲回 CultureNotFoundException。

另請參閱

• TextInfo
• CultureAndRegionInfoBuilder
• ClearCachedData()