CultureInfo Konstruktor
Definisi
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.
Menginisialisasi instans baru kelas CultureInfo.
Overload
CultureInfo(Int32) |
Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan oleh pengidentifikasi budaya. |
CultureInfo(String) |
Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan berdasarkan nama. |
CultureInfo(Int32, Boolean) |
Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan oleh pengidentifikasi budaya dan pada nilai yang menentukan apakah akan menggunakan pengaturan budaya yang dipilih pengguna dari Windows. |
CultureInfo(String, Boolean) |
Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan oleh nama dan pada nilai yang menentukan apakah akan menggunakan pengaturan budaya yang dipilih pengguna dari Windows. |
CultureInfo(Int32)
- Sumber:
- CultureInfo.cs
- Sumber:
- CultureInfo.cs
- Sumber:
- CultureInfo.cs
Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan oleh pengidentifikasi budaya.
public:
CultureInfo(int culture);
public CultureInfo (int culture);
new System.Globalization.CultureInfo : int -> System.Globalization.CultureInfo
Public Sub New (culture As Integer)
Parameter
- culture
- Int32
Pengidentifikasi yang telah CultureInfo ditentukan sebelumnya, LCID properti objek yang ada CultureInfo , atau pengidentifikasi budaya khusus Windows.
Pengecualian
culture
kurang dari nol.
culture
bukan pengidentifikasi budaya yang valid. Lihat bagian Catatan ke Penelepon untuk informasi selengkapnya.
Keterangan
Pengidentifikasi budaya yang telah ditentukan sebelumnya untuk budaya yang tersedia pada sistem Windows tercantum di kolom Tag bahasa dalam daftar nama bahasa/wilayah yang didukung oleh Windows. Nama budaya mengikuti standar yang ditentukan oleh BCP 47.
Dalam kebanyakan kasus, parameter dipetakan culture
ke pengidentifikasi lokal Dukungan Bahasa Nasional (NLS) yang sesuai. Nilai culture
parameter menjadi nilai LCID properti baru CultureInfo.
Kami menyarankan agar Anda memanggil konstruktor CultureInfo.CultureInfonama lokal , karena nama lokal lebih disukai daripada LCID. Untuk lokal kustom, nama lokal diperlukan.
Pengguna dapat memilih untuk mengambil alih beberapa nilai yang terkait dengan budaya Windows saat ini melalui bagian opsi regional dan bahasa panel kontrol. Misalnya, pengguna dapat memilih untuk menampilkan tanggal dalam format yang berbeda atau menggunakan mata uang selain default untuk budaya. Jika pengidentifikasi budaya yang ditentukan cocok dengan pengidentifikasi budaya budaya Windows saat ini, konstruktor ini membuat CultureInfo yang menggunakan penimpaan tersebut, termasuk pengaturan pengguna untuk properti DateTimeFormatInfo instans yang dikembalikan oleh DateTimeFormat properti , dan properti NumberFormatInfo instans yang dikembalikan oleh NumberFormat properti . Jika pengaturan pengguna tidak kompatibel dengan budaya yang terkait dengan CultureInfo (misalnya, jika kalender yang dipilih bukan salah satu dari OptionalCalendars) hasil metode dan nilai properti tidak terdefinisi.
Jika pengidentifikasi budaya yang ditentukan tidak cocok dengan pengidentifikasi budaya Windows saat ini, konstruktor ini membuat CultureInfo yang menggunakan nilai default untuk budaya yang ditentukan.
Properti UseUserOverride selalu diatur ke true
.
Misalnya, arab (Arab Saudi) adalah budaya Windows saat ini dan pengguna telah mengubah kalender dari Hijriah menjadi Gregorian.
Dengan
CultureInfo("0x0401")
(nama budaya ar-SA), Calendar diatur ke GregorianCalendar (yang merupakan pengaturan pengguna) dan UseUserOverride diatur ketrue
.Dengan
CultureInfo("0x041E")
(nama budaya th-TH), Calendar diatur ke ThaiBuddhistCalendar (yang merupakan kalender default untuk th-TH) dan UseUserOverride diatur ketrue
.
Untuk budaya yang menggunakan euro, .NET Framework dan Windows XP mengatur mata uang default sebagai euro. Namun, versi Windows yang lebih lama tidak. Oleh karena itu, jika pengguna versi Windows yang lebih lama belum mengubah pengaturan mata uang melalui bagian opsi regional dan bahasa Panel Kontrol, mata uang mungkin salah. Untuk menggunakan pengaturan default .NET Framework untuk mata uang, aplikasi harus menggunakan CultureInfo kelebihan beban konstruktor yang menerima useUserOverride
parameter dan mengaturnya ke false
.
Catatan
Untuk kompatibilitas mundur, budaya yang dibangun menggunakan culture
parameter 0x0004 atau 0x7c04 masing-masing akan memiliki Name properti zh-CHS
atau zh-CHT
, masing-masing. Anda harus lebih memilih untuk membangun budaya menggunakan nama budaya standar saat ini atau zh-Hans
zh-Hant
, kecuali Anda memiliki alasan untuk menggunakan nama yang lebih lama.
Catatan Bagi Pemanggil
.NET Framework 3.5 dan versi yang lebih lama melemparkan ArgumentException jika culture
bukan pengidentifikasi budaya yang valid. Dimulai dengan .NET Framework 4, konstruktor 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 untuk mengambil CultureInfo objek yang pengidentifikasinya berasal culture
dari sistem operasi; jika sistem operasi tidak mendukung budaya tersebut, 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 invariant ditentukan.
Lihat juga
Berlaku untuk
CultureInfo(String)
- Sumber:
- CultureInfo.cs
- Sumber:
- CultureInfo.cs
- Sumber:
- CultureInfo.cs
Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan berdasarkan nama.
public:
CultureInfo(System::String ^ name);
public CultureInfo (string name);
new System.Globalization.CultureInfo : string -> System.Globalization.CultureInfo
Public Sub New (name As String)
Parameter
- name
- String
Nama yang telah CultureInfo ditentukan sebelumnya, Name dari nama budaya , atau khusus Windows yang ada CultureInfo.
name
tidak peka huruf besar/kecil.
Pengecualian
name
adalah null.
name
bukan nama budaya yang valid. Untuk informasi selengkapnya, lihat bagian Catatan ke Penelepon.
Contoh
Contoh berikut mengambil budaya saat ini. Jika itu adalah sesuatu selain budaya Prancis (Prancis), ia memanggil CultureInfo(String) konstruktor untuk membuat CultureInfo instans objek yang mewakili budaya Prancis (Prancis) dan menjadikannya budaya saat ini. Jika tidak, ini membuat CultureInfo instans objek yang mewakili budaya Prancis (Luksemburg) dan menjadikannya budaya saat ini.
using System;
using System.Globalization;
public class ChangeEx1
{
public static void Main()
{
CultureInfo current = CultureInfo.CurrentCulture;
Console.WriteLine("The current culture is {0}", current.Name);
CultureInfo newCulture;
if (current.Name.Equals("fr-FR"))
newCulture = new CultureInfo("fr-LU");
else
newCulture = new CultureInfo("fr-FR");
CultureInfo.CurrentCulture = newCulture;
Console.WriteLine("The current culture is now {0}",
CultureInfo.CurrentCulture.Name);
}
}
// The example displays output like the following:
// The current culture is en-US
// The current culture is now fr-FR
Imports System.Globalization
Module Example
Public Sub Main()
Dim current As CultureInfo = CultureInfo.CurrentCulture
Console.WriteLine("The current culture is {0}", current.Name)
Dim newCulture As CultureInfo
If current.Name.Equals("fr-FR") Then
newCulture = New CultureInfo("fr-LU")
Else
newCulture = new CultureInfo("fr-FR")
End If
CultureInfo.CurrentCulture = newCulture
Console.WriteLine("The current culture is now {0}",
CultureInfo.CurrentCulture.Name)
End Sub
End Module
' The example displays output like the following:
' The current culture is en-US
' The current culture is now fr-FR
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.
Jika name
adalah String.Empty, konstruktor membuat instans budaya invarian; ini setara dengan mengambil nilai InvariantCulture properti.
Pengguna dapat memilih untuk mengambil alih beberapa nilai yang terkait dengan budaya Windows saat ini melalui bagian opsi regional dan bahasa panel kontrol. Misalnya, pengguna dapat memilih untuk menampilkan tanggal dalam format yang berbeda atau menggunakan mata uang selain default untuk budaya. Jika pengidentifikasi budaya yang terkait dengan name
pencocokan pengidentifikasi budaya budaya Windows saat ini, konstruktor ini membuat CultureInfo objek yang menggunakan penimpaan tersebut, termasuk pengaturan pengguna untuk properti DateTimeFormatInfo instans yang dikembalikan oleh DateTimeFormat properti , dan properti NumberFormatInfo instans yang dikembalikan oleh NumberFormat properti . Jika pengaturan pengguna tidak kompatibel dengan budaya yang terkait dengan CultureInfo, misalnya, jika kalender yang dipilih bukan salah satu dari OptionalCalendars, hasil metode dan nilai properti tidak terdefinisi.
Jika pengidentifikasi budaya yang terkait dengan tidak cocok dengan name
pengidentifikasi budaya budaya Windows saat ini, konstruktor ini membuat CultureInfo objek yang menggunakan nilai default untuk budaya yang ditentukan.
Properti UseUserOverride selalu diatur ke true
.
Misalnya, arab (Arab Saudi) adalah budaya Windows saat ini dan pengguna mengubah kalender dari Hijriah ke Gregorian:
- Dengan
CultureInfo("ar-SA")
, Calendar diatur ke GregorianCalendar (yang merupakan pengaturan pengguna) dan UseUserOverride diatur ketrue
. - Dengan
CultureInfo("th-TH")
, Calendar diatur ke ThaiBuddhistCalendar (yang merupakan kalender default untuk th-TH) dan UseUserOverride diatur ketrue
.
LCID Properti baru CultureInfo diatur ke pengidentifikasi budaya yang terkait dengan nama yang ditentukan.
Catatan Bagi Pemanggil
.NET Framework 3.5 dan versi yang lebih lama melemparkan ArgumentException jika name
bukan nama budaya yang valid. Dimulai dengan .NET Framework 4, konstruktor 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 tersebut, dan jika name
bukan nama budaya 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 invariant ditentukan.
Lihat juga
Berlaku untuk
CultureInfo(Int32, Boolean)
- Sumber:
- CultureInfo.cs
- Sumber:
- CultureInfo.cs
- Sumber:
- CultureInfo.cs
Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan oleh pengidentifikasi budaya dan pada nilai yang menentukan apakah akan menggunakan pengaturan budaya yang dipilih pengguna dari Windows.
public:
CultureInfo(int culture, bool useUserOverride);
public CultureInfo (int culture, bool useUserOverride);
new System.Globalization.CultureInfo : int * bool -> System.Globalization.CultureInfo
Public Sub New (culture As Integer, useUserOverride As Boolean)
Parameter
- culture
- Int32
Pengidentifikasi yang telah CultureInfo ditentukan sebelumnya, LCID properti objek yang ada CultureInfo , atau pengidentifikasi budaya khusus Windows.
- useUserOverride
- Boolean
true
untuk menggunakan pengaturan budaya yang dipilih pengguna (khusus Windows); false
untuk menggunakan pengaturan budaya default.
Pengecualian
culture
kurang dari nol.
culture
bukan pengidentifikasi budaya yang valid. Lihat bagian Catatan ke Penelepon untuk informasi selengkapnya.
Keterangan
Pengidentifikasi budaya yang telah ditentukan sebelumnya yang tersedia pada sistem Windows tercantum di kolom Tag bahasa dalam daftar nama bahasa/wilayah yang didukung oleh Windows. Nama budaya mengikuti standar yang ditentukan oleh BCP 47.
Dalam kebanyakan kasus, parameter dipetakan culture
ke pengidentifikasi lokal Dukungan Bahasa Nasional (NLS) yang sesuai. Nilai culture
parameter menjadi nilai LCID properti baru CultureInfo.
Kami menyarankan agar Anda memanggil konstruktor CultureInfo.CultureInfonama lokal , karena nama lokal lebih disukai daripada LCID. Untuk lokal kustom, nama lokal diperlukan.
Pengguna dapat memilih untuk mengambil alih beberapa nilai yang terkait dengan budaya Windows saat ini melalui bagian opsi regional dan bahasa panel kontrol. Misalnya, pengguna dapat memilih untuk menampilkan tanggal dalam format yang berbeda atau menggunakan mata uang selain default untuk budaya.
Aplikasi biasanya tidak boleh melarang penimpaan pengguna. Melarang penimpaan tidak menjamin stabilitas data. Untuk informasi selengkapnya, lihat entri blog Data budaya tidak boleh dianggap stabil (kecuali untuk Invariant).
UseUserOverride Jika properti diatur ke true
dan pengidentifikasi budaya yang ditentukan cocok dengan pengidentifikasi budaya Windows saat ini, konstruktor ini membuat CultureInfo yang menggunakan penimpaan tersebut, termasuk pengaturan pengguna untuk properti DateTimeFormatInfo instans yang dikembalikan oleh DateTimeFormat properti , dan properti NumberFormatInfo instans yang dikembalikan oleh NumberFormat properti . Jika pengaturan pengguna tidak kompatibel dengan budaya yang terkait dengan CultureInfo, misalnya, jika kalender yang dipilih bukan salah satu dari OptionalCalendars, hasil metode dan nilai properti tidak terdefinisi.
Jika tidak, konstruktor ini membuat CultureInfo yang menggunakan nilai default untuk budaya yang ditentukan.
Nilai useUserOverride
parameter menjadi nilai UseUserOverride properti .
Misalnya, arab (Arab Saudi) adalah budaya Windows saat ini dan pengguna telah mengubah kalender dari Hijriah menjadi Gregorian.
Dengan
CultureInfo("0x0401", true)
(nama budaya ar-SA), Calendar diatur ke GregorianCalendar (yang merupakan pengaturan pengguna) dan UseUserOverride diatur ketrue
.Dengan
CultureInfo("0x0401", false)
(nama budaya ar-SA), Calendar diatur ke HijriCalendar (yang merupakan kalender default untuk ar-SA) dan UseUserOverride diatur kefalse
.Dengan
CultureInfo("0x041E", true)
(nama budaya th-TH), Calendar diatur ke ThaiBuddhistCalendar (yang merupakan kalender default untuk th-TH) dan UseUserOverride diatur ketrue
.Dengan
CultureInfo("0x041E", false)
(nama budaya th-TH), Calendar diatur ke ThaiBuddhistCalendar (yang merupakan kalender default untuk th-TH) dan UseUserOverride diatur kefalse
.
Untuk budaya yang menggunakan euro, .NET Framework dan Windows XP menetapkan mata uang default sebagai euro. Namun, versi Windows yang lebih lama tidak. Oleh karena itu, jika pengguna versi Windows yang lebih lama belum mengubah pengaturan mata uang melalui bagian opsi regional dan bahasa panel kontrol, mata uang mungkin salah. Untuk menggunakan pengaturan default .NET Framework untuk mata uang, aplikasi harus mengatur parameter ke useUserOverride
false
.
Catatan
Untuk kompatibilitas mundur, budaya yang dibangun menggunakan culture
parameter 0x0004 atau 0x7c04 masing-masing akan memiliki Name properti zh-CHS atau zh-CHT. Anda harus lebih memilih untuk membangun budaya menggunakan nama zh-Hans
budaya standar saat ini atau zh-Hant, kecuali Anda memiliki alasan untuk menggunakan nama yang lebih lama.
Catatan Bagi Pemanggil
.NET Framework 3.5 dan versi yang lebih lama melemparkan ArgumentException jika culture
bukan pengidentifikasi budaya yang valid. Dimulai dengan .NET Framework 4, konstruktor 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 untuk mengambil CultureInfo objek yang pengidentifikasinya berasal culture
dari sistem operasi; jika sistem operasi tidak mendukung budaya tersebut, 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 invariant ditentukan.
Lihat juga
Berlaku untuk
CultureInfo(String, Boolean)
- Sumber:
- CultureInfo.cs
- Sumber:
- CultureInfo.cs
- Sumber:
- CultureInfo.cs
Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan oleh nama dan pada nilai yang menentukan apakah akan menggunakan pengaturan budaya yang dipilih pengguna dari Windows.
public:
CultureInfo(System::String ^ name, bool useUserOverride);
public CultureInfo (string name, bool useUserOverride);
new System.Globalization.CultureInfo : string * bool -> System.Globalization.CultureInfo
Public Sub New (name As String, useUserOverride As Boolean)
Parameter
- name
- String
Nama yang telah CultureInfo ditentukan sebelumnya, Name dari nama budaya , atau khusus Windows yang ada CultureInfo.
name
tidak peka huruf besar/kecil.
- useUserOverride
- Boolean
true
untuk menggunakan pengaturan budaya yang dipilih pengguna (khusus Windows); false
untuk menggunakan pengaturan budaya default.
Pengecualian
name
adalah null.
name
bukan nama budaya yang valid. Lihat bagian Catatan untuk Penelepon untuk informasi selengkapnya.
Keterangan
Untuk daftar nama budaya yang telah ditentukan sebelumnya, 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.
Jika name
adalah String.Empty, konstruktor membuat instans budaya invarian; ini setara dengan mengambil nilai InvariantCulture properti.
Pengguna mungkin memilih untuk mengambil alih beberapa nilai yang terkait dengan budaya Windows saat ini melalui bagian opsi regional dan bahasa panel kontrol. Misalnya, pengguna dapat memilih untuk menampilkan tanggal dalam format yang berbeda atau menggunakan mata uang selain default untuk budaya.
Aplikasi biasanya tidak boleh melarang penimpaan pengguna. Melarang penimpaan tidak menjamin stabilitas data. Untuk informasi selengkapnya, lihat entri blog Data budaya tidak boleh dianggap stabil (kecuali untuk Invarian).
UseUserOverride Jika properti diatur ke true
dan pengidentifikasi budaya yang terkait dengan nama budaya yang ditentukan cocok dengan pengidentifikasi budaya budaya Windows saat ini, konstruktor ini membuat CultureInfo yang menggunakan penimpaan tersebut, termasuk pengaturan pengguna untuk properti DateTimeFormatInfo instans yang dikembalikan oleh DateTimeFormat properti , dan properti NumberFormatInfo instans yang dikembalikan oleh NumberFormat properti . Jika pengaturan pengguna tidak kompatibel dengan budaya yang terkait dengan CultureInfo, misalnya, jika kalender yang dipilih bukan salah satu dari OptionalCalendars, hasil metode dan nilai properti tidak terdefinisi.
Jika tidak, konstruktor ini membuat CultureInfo yang menggunakan nilai default untuk budaya yang ditentukan.
Nilai useUserOverride
parameter menjadi nilai UseUserOverride properti .
Misalnya, misalkan Arab (Arab Saudi) adalah budaya Windows saat ini dan pengguna mengubah kalender dari Hijriah ke Gregorian.
Dengan
CultureInfo("ar-SA", true)
, Calendar diatur ke GregorianCalendar (yang merupakan pengaturan pengguna) dan UseUserOverride diatur ketrue
.Dengan
CultureInfo("ar-SA", false)
, Calendar diatur ke HijriCalendar (yang merupakan kalender default untuk ar-SA) dan UseUserOverride diatur kefalse
.Dengan
CultureInfo("th-TH", true)
, Calendar diatur ke ThaiBuddhistCalendar (yang merupakan kalender default untuk th-TH) dan UseUserOverride diatur ketrue
.Dengan
CultureInfo("th-TH", false)
, Calendar diatur ke ThaiBuddhistCalendar (yang merupakan kalender default untuk th-TH) dan UseUserOverride diatur kefalse
.
LCID Properti baru CultureInfo diatur ke pengidentifikasi budaya yang terkait dengan nama yang ditentukan.
Untuk budaya yang menggunakan euro, .NET Framework dan Windows XP menetapkan mata uang default sebagai euro. Namun, versi Windows yang lebih lama tidak melakukan ini. Oleh karena itu, jika pengguna versi Windows yang lebih lama belum mengubah pengaturan mata uang melalui bagian opsi regional dan bahasa panel kontrol, mata uang mungkin salah. Untuk menggunakan pengaturan default .NET Framework untuk mata uang, aplikasi harus mengatur parameter ke useUserOverride
false
.
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, konstruktor 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 budaya tambahan atau penggantian, metode melemparkan 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.