CultureInfo Kelas

Definisi

Menyediakan informasi tentang budaya tertentu (disebut lokal untuk pengembangan kode yang tidak dikelola). Informasi tersebut mencakup nama untuk budaya, sistem penulisan, kalender yang digunakan, urutan pengurutan string, dan pemformatan untuk tanggal dan angka.

public ref class CultureInfo : IFormatProvider
public ref class CultureInfo : ICloneable, IFormatProvider
public class CultureInfo : IFormatProvider
public class CultureInfo : ICloneable, IFormatProvider
[System.Serializable]
public class CultureInfo : ICloneable, IFormatProvider
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class CultureInfo : ICloneable, IFormatProvider
type CultureInfo = class
    interface IFormatProvider
type CultureInfo = class
    interface ICloneable
    interface IFormatProvider
[<System.Serializable>]
type CultureInfo = class
    interface ICloneable
    interface IFormatProvider
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CultureInfo = class
    interface ICloneable
    interface IFormatProvider
Public Class CultureInfo
Implements IFormatProvider
Public Class CultureInfo
Implements ICloneable, IFormatProvider
Warisan
CultureInfo
Atribut
Penerapan

Contoh

Contoh berikut menunjukkan cara membuat CultureInfo objek untuk Bahasa Spanyol (Spanyol) dengan sortir internasional dan objek lain CultureInfo dengan jenis tradisional.

using namespace System;
using namespace System::Collections;
using namespace System::Globalization;
int main()
{
   
   // Creates and initializes the CultureInfo which uses the international sort.
   CultureInfo^ myCIintl = gcnew CultureInfo( "es-ES",false );
   
   // Creates and initializes the CultureInfo which uses the traditional sort.
   CultureInfo^ myCItrad = gcnew CultureInfo( 0x040A,false );
   
   // Displays the properties of each culture.
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL" );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl->CompareInfo, myCItrad->CompareInfo );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl->DisplayName, myCItrad->DisplayName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl->EnglishName, myCItrad->EnglishName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl->IsNeutralCulture, myCItrad->IsNeutralCulture );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl->IsReadOnly, myCItrad->IsReadOnly );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "LCID", myCIintl->LCID, myCItrad->LCID );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "Name", myCIintl->Name, myCItrad->Name );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl->NativeName, myCItrad->NativeName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "Parent", myCIintl->Parent, myCItrad->Parent );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl->TextInfo, myCItrad->TextInfo );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl->ThreeLetterISOLanguageName, myCItrad->ThreeLetterISOLanguageName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl->ThreeLetterWindowsLanguageName, myCItrad->ThreeLetterWindowsLanguageName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl->TwoLetterISOLanguageName, myCItrad->TwoLetterISOLanguageName );
   Console::WriteLine();
   
   // Compare two strings using myCIintl -> 
   Console::WriteLine( "Comparing \"llegar\" and \"lugar\"" );
   Console::WriteLine( "   With myCIintl -> CompareInfo -> Compare: {0}", myCIintl->CompareInfo->Compare( "llegar", "lugar" ) );
   Console::WriteLine( "   With myCItrad -> CompareInfo -> Compare: {0}", myCItrad->CompareInfo->Compare( "llegar", "lugar" ) );
}

/*
This code produces the following output.

PROPERTY                       INTERNATIONAL                                  TRADITIONAL              
CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
DisplayName                    Spanish (Spain)                                Spanish (Spain)          
EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
IsNeutralCulture               False                                          False                    
IsReadOnly                     False                                          False                    
LCID                           3082                                           1034                     
Name                           es-ES                                          es-ES                    
NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
Parent                         es                                             es                       
TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl  
ThreeLetterISOLanguageName     spa                                            spa                      
ThreeLetterWindowsLanguageName ESN                                            ESP                      
TwoLetterISOLanguageName       es                                             es                       

Comparing "llegar" and "lugar"
   With myCIintl -> CompareInfo -> Compare: -1
   With myCItrad -> CompareInfo -> Compare: 1

*/
using System;
using System.Globalization;

public class SamplesCultureInfo
{
    public static void Main()
    {
        // Creates and initializes the CultureInfo which uses the international sort.
        CultureInfo myCIintl = new CultureInfo("es-ES", false);

        // Creates and initializes the CultureInfo which uses the traditional sort.
        CultureInfo myCItrad = new CultureInfo(0x040A, false);

        // Displays the properties of each culture.
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL");
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl.CompareInfo, myCItrad.CompareInfo);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl.DisplayName, myCItrad.DisplayName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl.EnglishName, myCItrad.EnglishName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl.IsNeutralCulture, myCItrad.IsNeutralCulture);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl.IsReadOnly, myCItrad.IsReadOnly);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "LCID", myCIintl.LCID, myCItrad.LCID);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Name", myCIintl.Name, myCItrad.Name);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl.NativeName, myCItrad.NativeName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Parent", myCIintl.Parent, myCItrad.Parent);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl.TextInfo, myCItrad.TextInfo);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl.ThreeLetterISOLanguageName, myCItrad.ThreeLetterISOLanguageName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl.ThreeLetterWindowsLanguageName, myCItrad.ThreeLetterWindowsLanguageName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl.TwoLetterISOLanguageName, myCItrad.TwoLetterISOLanguageName);
        Console.WriteLine();

        // Compare two strings using myCIintl.
        Console.WriteLine("Comparing \"llegar\" and \"lugar\"");
        Console.WriteLine("   With myCIintl.CompareInfo.Compare: {0}", myCIintl.CompareInfo.Compare("llegar", "lugar"));
        Console.WriteLine("   With myCItrad.CompareInfo.Compare: {0}", myCItrad.CompareInfo.Compare("llegar", "lugar"));
    }
}

/*
This code produces the following output.

PROPERTY                       INTERNATIONAL                                  TRADITIONAL
CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
DisplayName                    Spanish (Spain)                                Spanish (Spain)
EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
IsNeutralCulture               False                                          False
IsReadOnly                     False                                          False
LCID                           3082                                           1034
Name                           es-ES                                          es-ES
NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
Parent                         es                                             es
TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl
ThreeLetterISOLanguageName     spa                                            spa
ThreeLetterWindowsLanguageName ESN                                            ESP
TwoLetterISOLanguageName       es                                             es

Comparing "llegar" and "lugar"
   With myCIintl.CompareInfo.Compare: -1
   With myCItrad.CompareInfo.Compare: 1

*/
Imports System.Collections
Imports System.Globalization

Module Module1

    Public Sub Main()

        ' Creates and initializes the CultureInfo which uses the international sort.
        Dim myCIintl As New CultureInfo("es-ES", False)

        ' Creates and initializes the CultureInfo which uses the traditional sort.
        Dim myCItrad As New CultureInfo(&H40A, False)

        ' Displays the properties of each culture.
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL")
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl.CompareInfo, myCItrad.CompareInfo)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl.DisplayName, myCItrad.DisplayName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl.EnglishName, myCItrad.EnglishName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl.IsNeutralCulture, myCItrad.IsNeutralCulture)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl.IsReadOnly, myCItrad.IsReadOnly)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "LCID", myCIintl.LCID, myCItrad.LCID)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Name", myCIintl.Name, myCItrad.Name)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl.NativeName, myCItrad.NativeName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Parent", myCIintl.Parent, myCItrad.Parent)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl.TextInfo, myCItrad.TextInfo)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl.ThreeLetterISOLanguageName, myCItrad.ThreeLetterISOLanguageName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl.ThreeLetterWindowsLanguageName, myCItrad.ThreeLetterWindowsLanguageName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl.TwoLetterISOLanguageName, myCItrad.TwoLetterISOLanguageName)
        Console.WriteLine()

        ' Compare two strings using myCIintl.
        Console.WriteLine("Comparing ""llegar"" and ""lugar""")
        Console.WriteLine("   With myCIintl.CompareInfo.Compare: {0}", myCIintl.CompareInfo.Compare("llegar", "lugar"))
        Console.WriteLine("   With myCItrad.CompareInfo.Compare: {0}", myCItrad.CompareInfo.Compare("llegar", "lugar"))

    End Sub



'This code produces the following output.
'
'PROPERTY                       INTERNATIONAL                                  TRADITIONAL              
'CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
'DisplayName                    Spanish (Spain)                                Spanish (Spain)          
'EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
'IsNeutralCulture               False                                          False                    
'IsReadOnly                     False                                          False                    
'LCID                           3082                                           1034                     
'Name                           es-ES                                          es-ES                    
'NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
'Parent                         es                                             es                       
'TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl  
'ThreeLetterISOLanguageName     spa                                            spa                      
'ThreeLetterWindowsLanguageName ESN                                            ESP                      
'TwoLetterISOLanguageName       es                                             es                       
'
'Comparing "llegar" and "lugar"
'   With myCIintl.CompareInfo.Compare: -1
'   With myCItrad.CompareInfo.Compare: 1

End Module

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk CultureInfo.

Konstruktor

CultureInfo(Int32)

Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan oleh pengidentifikasi budaya.

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)

Menginisialisasi instans CultureInfo baru kelas berdasarkan budaya yang ditentukan berdasarkan nama.

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.

Properti

Calendar

Mendapatkan kalender default yang digunakan oleh budaya.

CompareInfo

CompareInfo Mendapatkan yang menentukan cara membandingkan string untuk budaya.

CultureTypes

Mendapatkan jenis budaya yang berkaitan dengan objek saat ini CultureInfo .

CurrentCulture

Mendapatkan atau mengatur CultureInfo objek yang mewakili budaya yang digunakan oleh utas saat ini dan operasi asinkron berbasis tugas.

CurrentUICulture

Mendapatkan atau mengatur CultureInfo objek yang mewakili budaya antarmuka pengguna saat ini yang digunakan oleh Resource Manager untuk mencari sumber daya khusus budaya pada durasi.

DateTimeFormat

Mendapatkan atau menetapkan DateTimeFormatInfo yang mendefinisikan format tanggal dan waktu yang sesuai secara budaya.

DefaultThreadCurrentCulture

Mendapatkan atau mengatur budaya default untuk utas di domain aplikasi saat ini.

DefaultThreadCurrentUICulture

Mendapatkan atau mengatur budaya UI default untuk utas di domain aplikasi saat ini.

DisplayName

Mendapatkan nama budaya lengkap yang dilokalkan.

EnglishName

Mendapatkan nama budaya dalam format languagefull [country/regionfull] dalam bahasa Inggris.

IetfLanguageTag

Dihentikan. Mendapatkan identifikasi standar RFC 4646 untuk bahasa.

InstalledUICulture

CultureInfo Mendapatkan yang mewakili budaya yang diinstal dengan sistem operasi.

InvariantCulture

CultureInfo Mendapatkan objek yang independen terhadap budaya (invarian).

IsNeutralCulture

Mendapatkan nilai yang menunjukkan apakah saat ini CultureInfo mewakili budaya netral.

IsReadOnly

Mendapatkan nilai yang menunjukkan apakah saat ini CultureInfo bersifat baca-saja.

KeyboardLayoutId

Mendapatkan pengidentifikasi lokal input aktif.

LCID

Mendapatkan pengidentifikasi budaya untuk saat ini CultureInfo.

Name

Mendapatkan nama budaya dalam format languagecode2-country/regioncode2.

NativeName

Mendapatkan nama budaya, yang terdiri dari bahasa, negara/wilayah, dan skrip opsional, yang diatur ke budaya untuk ditampilkan.

NumberFormat

Mendapatkan atau mengatur NumberFormatInfo yang mendefinisikan format yang sesuai secara budaya untuk menampilkan angka, mata uang, dan persentase.

OptionalCalendars

Mendapatkan daftar kalender yang dapat digunakan oleh budaya.

Parent

CultureInfo Mendapatkan yang mewakili budaya induk dari saat ini CultureInfo.

TextInfo

TextInfo Mendapatkan yang mendefinisikan sistem penulisan yang terkait dengan budaya.

ThreeLetterISOLanguageName

Mendapatkan kode tiga huruf ISO 639-2 untuk bahasa saat ini CultureInfo.

ThreeLetterWindowsLanguageName

Mendapatkan kode tiga huruf untuk bahasa seperti yang didefinisikan dalam Windows API.

TwoLetterISOLanguageName

Mendapatkan kode tiga huruf ISO 639-1 atau ISO 639-3 untuk bahasa dari .CultureInfo

UseUserOverride

Mendapatkan nilai yang menunjukkan apakah objek saat ini CultureInfo menggunakan pengaturan budaya yang dipilih pengguna.

Metode

ClearCachedData()

Menyegarkan informasi terkait budaya yang di-cache.

Clone()

Membuat salinan dari saat ini CultureInfo.

CreateSpecificCulture(String)

CultureInfo Membuat yang mewakili budaya tertentu yang terkait dengan nama yang ditentukan.

Equals(Object)

Menentukan apakah objek yang ditentukan adalah budaya yang sama dengan saat ini CultureInfo.

GetConsoleFallbackUICulture()

Mendapatkan budaya antarmuka pengguna alternatif yang cocok untuk aplikasi konsol ketika budaya antarmuka pengguna grafis default tidak cocok.

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)

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.

GetCultureInfoByIetfLanguageTag(String)

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

GetCultures(CultureTypes)

Mendapatkan daftar budaya yang didukung yang difilter oleh parameter yang ditentukan CultureTypes .

GetFormat(Type)

Mendapatkan objek yang menentukan cara memformat jenis yang ditentukan.

GetHashCode()

Berfungsi sebagai fungsi hash untuk saat ini CultureInfo, cocok untuk algoritma hash dan struktur data, seperti tabel hash.

GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
ReadOnly(CultureInfo)

Mengembalikan pembungkus baca-saja di sekitar objek yang ditentukan CultureInfo .

ToString()

Mengembalikan string yang berisi nama saat ini CultureInfo dalam format languagecode2-negara/regioncode2.

Berlaku untuk

Lihat juga