CultureInfo Konstruktor

  • Referensi

Definisi

Ruang nama:
System.Globalization
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll
Rakitan:
System.Globalization.dll

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

ArgumentOutOfRangeException

culture kurang dari nol.

CultureNotFoundException

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 dari 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.

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-Hanszh-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

ArgumentNullException

name adalah null.

CultureNotFoundException

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 dari 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:

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 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 ini 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

ArgumentOutOfRangeException

culture kurang dari nol.

CultureNotFoundException

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 dari 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.

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 useUserOverridefalse.

Catatan

Untuk kompatibilitas mundur, budaya yang dibangun menggunakan culture parameter 0x0004 atau 0x7c04 akan memiliki Name properti masing-masing 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

ArgumentNullException

name adalah null.

CultureNotFoundException

name bukan nama budaya yang valid. Lihat bagian Catatan ke 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 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 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, arab (Arab Saudi) adalah budaya Windows saat ini dan pengguna mengubah kalender dari Hijriah ke Gregorian.

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 useUserOverridefalse.

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 ini 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