CultureInfo.GetCultureInfo Metode

Definisi

Ruang nama:

System.Globalization

Rakitan:

System.Runtime.dll

Mengambil instans budaya yang di-cache dan baca-saja.

Overload

GetCultureInfo(String, Boolean)	Mengambil instans budaya yang di-cache dan baca-saja.
GetCultureInfo(String, String)	Mengambil instans budaya yang di-cache dan baca-saja. Parameter menentukan budaya yang diinisialisasi dengan TextInfo objek dan CompareInfo yang ditentukan oleh budaya lain.
GetCultureInfo(Int32)	Mengambil instans budaya baca-saja yang di-cache dengan menggunakan pengidentifikasi budaya yang ditentukan.
GetCultureInfo(String)	Mengambil instans budaya baca-saja yang di-cache menggunakan nama budaya yang ditentukan.

GetCultureInfo(String, Boolean)

Sumber:

CultureInfo.cs

Mengambil instans budaya yang di-cache dan baca-saja.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, bool predefinedOnly);

public static System.Globalization.CultureInfo GetCultureInfo (string name, bool predefinedOnly);

static member GetCultureInfo : string * bool -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfo

Parameter

name

String

Nama budaya. Ini tidak peka huruf besar/kecil.

predefinedOnly

Boolean

true jika meminta untuk membuat instans budaya yang diketahui oleh platform. false jika tidak apa-apa untuk mengulangi budaya buatan bahkan jika platform tidak membawa data untuk itu.

Mengembalikan

CultureInfo

Contoh budaya baca-saja.

Keterangan

Secara default, ketika mencoba membuat budaya apa pun dan platform yang mendasar (Windows NLS atau ICU) tidak membawa data khusus untuk budaya ini, platform akan mencoba membangun budaya dengan data dari budaya lain atau beberapa nilai konstan.

Pengaturan predefinedOnly ke true akan memastikan budaya dibuat hanya jika platform memiliki data nyata untuk budaya tersebut.

GetCultureInfo(String, String)

Sumber:

CultureInfo.cs

Mengambil instans budaya yang di-cache dan baca-saja. Parameter menentukan budaya yang diinisialisasi dengan TextInfo objek dan CompareInfo yang ditentukan oleh budaya lain.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, System::String ^ altName);

public static System.Globalization.CultureInfo GetCultureInfo (string name, string altName);

static member GetCultureInfo : string * string -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfo (name As String, altName As String) As CultureInfo

Parameter

name

String

Nama budaya. name tidak peka huruf besar/kecil.

altName

String

Nama budaya yang memasok TextInfo objek dan CompareInfo yang digunakan untuk menginisialisasi name. altName tidak peka huruf besar/kecil.

Mengembalikan

CultureInfo

Objek baca-saja CultureInfo .

Pengecualian

ArgumentNullException

name atau altName adalah null.

CultureNotFoundException

name atau altName menentukan budaya yang tidak didukung. Lihat bagian Catatan untuk Penelepon untuk informasi selengkapnya.

Keterangan

Untuk daftar nama budaya yang telah ditentukan sebelumnya pada sistem Windows, lihat kolom Tag bahasa dalam daftar nama bahasa/wilayah yang didukung oleh Windows. Nama budaya mengikuti standar yang ditentukan oleh BCP 47. Selain itu, dimulai dengan Windows 10, name dapat berupa tag bahasa BCP-47 yang valid.

Metode ini GetCultureInfo mendapatkan objek baca-saja CultureInfo yang di-cache. Ini menawarkan performa yang lebih baik daripada panggilan yang sesuai ke CultureInfo konstruktor. Metode ini digunakan untuk membuat budaya yang mirip dengan yang ditentukan oleh name parameter, tetapi dengan aturan pengurutan dan casing yang berbeda.

Jika name atau altName adalah nama budaya saat ini, objek yang dikembalikan tidak mencerminkan penimpaan pengguna apa pun. Jika name adalah String.Empty, metode mengembalikan budaya invarian. Ini setara dengan mengambil nilai InvariantCulture properti . Jika altName adalah String.Empty, metode ini menggunakan sistem penulisan dan aturan perbandingan yang ditentukan oleh budaya invarian.

Catatan Bagi Pemanggil

.NET Framework 3.5 dan versi yang lebih lama menampilkan ArgumentException jika name atau altName bukan nama budaya yang valid. Dimulai dengan .NET Framework 4, metode ini melempar CultureNotFoundException. Dimulai dengan aplikasi yang berjalan di bawah .NET Framework 4 atau yang lebih baru pada Windows 7 atau yang lebih baru, metode mencoba untuk mengambil CultureInfo objek yang pengidentifikasinya berasal name dari sistem operasi; jika sistem operasi tidak mendukung budaya itu, dan jika name bukan nama kultur tambahan atau penggantian, metode ini memberikan CultureNotFoundException pengecualian.

Pada .NET 6 dan versi yang CultureNotFoundException lebih baru, dilemparkan jika aplikasi berjalan di lingkungan tempat mode globalisasi-invariant diaktifkan, misalnya, beberapa kontainer Docker, dan budaya selain budaya invarian ditentukan.

Lihat juga

• Name
• ClearCachedData()

GetCultureInfo(Int32)

Sumber:

CultureInfo.cs

Mengambil instans budaya baca-saja yang di-cache dengan menggunakan pengidentifikasi budaya yang ditentukan.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(int culture);

public static System.Globalization.CultureInfo GetCultureInfo (int culture);

static member GetCultureInfo : int -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfo (culture As Integer) As CultureInfo

Parameter

culture

Int32

Pengidentifikasi lokal (LCID).

Mengembalikan

CultureInfo

Objek baca-saja CultureInfo .

Pengecualian

ArgumentOutOfRangeException

culture kurang dari nol.

CultureNotFoundException

culture menentukan budaya yang tidak didukung. Lihat bagian Catatan ke Penelepon untuk informasi selengkapnya.

Keterangan

Kami menyarankan agar Anda menggunakan kelebihan string metode ini (GetCultureInfo(String)), karena nama lokal harus digunakan alih-alih LCID. Untuk lokal kustom, nama lokal diperlukan.

Jika culture adalah pengidentifikasi lokal dari budaya saat ini, objek yang dikembalikan tidak mencerminkan CultureInfo penimpaan pengguna apa pun.

Catatan Bagi Pemanggil

.NET Framework 3.5 dan versi yang lebih lama menampilkan ArgumentException jika culture bukan pengidentifikasi budaya yang valid. Dimulai dengan .NET Framework 4, metode ini melempar CultureNotFoundException. Dimulai dengan aplikasi yang berjalan di bawah .NET Framework 4 atau yang lebih baru pada Windows 7 atau yang lebih baru, metode ini mencoba mengambil CultureInfo objek yang pengidentifikasinya berasal culture dari sistem operasi; jika sistem operasi tidak mendukung budaya itu, metode melempar CultureNotFoundException.

Pada .NET 6 dan versi yang CultureNotFoundException lebih baru, dilemparkan jika aplikasi berjalan di lingkungan tempat mode globalisasi-invariant diaktifkan, misalnya, beberapa kontainer Docker, dan budaya selain budaya invarian ditentukan.

Lihat juga

• LCID
• ClearCachedData()

GetCultureInfo(String)

Sumber:

CultureInfo.cs

Mengambil instans budaya baca-saja yang di-cache menggunakan nama budaya yang ditentukan.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name);

public static System.Globalization.CultureInfo GetCultureInfo (string name);

static member GetCultureInfo : string -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfo (name As String) As CultureInfo

Parameter

name

String

Nama budaya. name tidak peka huruf besar/kecil.

Mengembalikan

CultureInfo

Objek baca-saja CultureInfo .

Pengecualian

ArgumentNullException

name adalah null.

CultureNotFoundException

name menentukan budaya yang tidak didukung. Lihat bagian Catatan untuk Penelepon untuk informasi selengkapnya.

Keterangan

Untuk daftar nama budaya yang telah ditentukan sebelumnya pada sistem Windows, lihat kolom Tag bahasa dalam daftar nama bahasa/wilayah yang didukung oleh Windows. Nama budaya mengikuti standar yang ditentukan oleh BCP 47. Selain itu, dimulai dengan Windows 10, name dapat berupa tag bahasa BCP-47 yang valid.

Metode ini GetCultureInfo mengambil objek baca-saja CultureInfo yang di-cache. Ini menawarkan performa yang lebih baik daripada panggilan yang sesuai ke CultureInfo.CultureInfo(String) konstruktor.

Jika name adalah nama budaya saat ini, objek yang dikembalikan tidak mencerminkan CultureInfo penimpaan pengguna apa pun. Ini membuat metode ini cocok untuk aplikasi server atau alat yang tidak memiliki akun pengguna nyata pada sistem dan yang perlu memuat beberapa budaya secara efisien.

Jika name adalah String.Empty, metode mengembalikan budaya invarian. Ini setara dengan mengambil nilai InvariantCulture properti .

Catatan Bagi Pemanggil

.NET Framework 3.5 dan versi yang lebih lama menampilkan ArgumentException jika name bukan nama budaya yang valid. Dimulai dengan .NET Framework 4, metode ini melempar CultureNotFoundException. Dimulai dengan aplikasi yang berjalan di bawah .NET Framework 4 atau yang lebih baru pada Windows 7 atau yang lebih baru, metode mencoba untuk mengambil CultureInfo objek yang pengidentifikasinya name berasal dari sistem operasi; jika sistem operasi tidak mendukung budaya itu, dan jika name bukan nama kultur tambahan atau penggantian, metode melempar CultureNotFoundException.

Pada .NET 6 dan versi yang CultureNotFoundException lebih baru, dilemparkan jika aplikasi berjalan di lingkungan tempat mode globalisasi-invariant diaktifkan, misalnya, beberapa kontainer Docker, dan budaya selain budaya invarian ditentukan.

Lihat juga

• Name