CultureInfo.GetCultureInfoByIetfLanguageTag(String) Metode

Referensi

Definisi

Ruang nama:: System.Globalization

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Sumber:: CultureInfo.cs

Sumber:: CultureInfo.cs

Sumber:: CultureInfo.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Dihentikan. Mengambil objek baca-saja CultureInfo yang memiliki karakteristik linguistik yang diidentifikasi oleh tag bahasa RFC 4646 yang ditentukan.

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

Parameter

name: String

Nama bahasa seperti yang ditentukan oleh standar RFC 4646.

Mengembalikan

CultureInfo

Objek baca-saja CultureInfo .

Pengecualian

ArgumentNullException

name adalah null.

CultureNotFoundException

name tidak sesuai dengan budaya yang didukung.

Keterangan

Catatan

Metode ini dan IetfLanguageTag properti tidak digunakan lagi. Alih-alih menggunakan API ini, sebaiknya gunakan CultureInfo konstruktor, CultureInfo.GetCultureInfo, dan Name properti . Tag dan nama IETF identik.

Standar RFC 4646 yang dikelola oleh Internet Engineering Task Force (IETF) mendefinisikan tag bahasa IETF, yang menyediakan sarana yang seragam untuk mengidentifikasi bahasa. Format tag bahasa IETF sama dengan nama budaya yang dikembalikan oleh Name properti , tetapi tidak mengidentifikasi budaya secara unik. Budaya yang berbeda memiliki tag bahasa IETF yang sama jika budaya tersebut memiliki karakteristik linguistik yang identik. Karakteristik linguistik budaya terkandung dalam objek yang TextInfo CultureInfo terkait dengan objek .

Tag bahasa IETF terdiri dari pengidentifikasi bahasa wajib, pengidentifikasi skrip opsional, dan pengidentifikasi wilayah opsional.

Aplikasi Anda harus menggunakan budaya yang diambil untuk mengontrol tugas khusus bahasa, seperti mengelola pemeriksa ejaan atau tata bahasa. Aplikasi tidak boleh menggunakan budaya yang diambil untuk mengontrol tugas khusus budaya, seperti mengurutkan teks atau waktu dan tanggal pemformatan.

Untuk informasi selengkapnya, lihat RFC 4646 - "Tag untuk Mengidentifikasi Bahasa.

Catatan Bagi Pemanggil

.NET Framework 3.5 dan versi yang lebih lama melempar ArgumentException jika name tidak sesuai dengan nama budaya yang didukung. Dimulai dengan .NET Framework 4, metode ini melempar CultureNotFoundException.

Berlaku untuk