Udostępnij za pośrednictwem


CultureInfo Klasa

Definicja

Zawiera informacje o określonej kulturze (nazywane ustawieniami regionalnymi na potrzeby tworzenia kodu niezarządzanego). Informacje zawierają nazwy kultury, systemu pisania, używanego kalendarza, kolejności sortowania ciągów oraz formatowania dat i liczb.

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
Dziedziczenie
CultureInfo
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie pokazano, jak utworzyć CultureInfo obiekt dla języka hiszpańskiego (Hiszpania) z sortowaniem międzynarodowym i innym CultureInfo obiektem z tradycyjnym sortowaniem.

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

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla informacji o kulturze.

Konstruktory

CultureInfo(Int32)

Inicjuje CultureInfo nowe wystąpienie klasy na podstawie kultury określonej przez identyfikator kultury.

CultureInfo(Int32, Boolean)

Inicjuje CultureInfo nowe wystąpienie klasy w oparciu o kulturę określoną przez identyfikator kultury i wartość określającą, czy używać ustawień kultury wybranych przez użytkownika z systemu Windows.

CultureInfo(String)

Inicjuje CultureInfo nowe wystąpienie klasy na podstawie kultury określonej przez nazwę.

CultureInfo(String, Boolean)

Inicjuje CultureInfo nowe wystąpienie klasy w oparciu o kulturę określoną przez nazwę i wartość określającą, czy używać ustawień kultury wybranych przez użytkownika z systemu Windows.

Właściwości

Calendar

Pobiera domyślny kalendarz używany przez kulturę.

CompareInfo

Pobiera element CompareInfo definiujący sposób porównywania ciągów dla kultury.

CultureTypes

Pobiera typy kultury odnoszące się do bieżącego CultureInfo obiektu.

CurrentCulture

Pobiera lub ustawia CultureInfo obiekt reprezentujący kulturę używaną przez bieżący wątek i operacje asynchroniczne oparte na zadaniach.

CurrentUICulture

Pobiera lub ustawia CultureInfo obiekt reprezentujący bieżącą kulturę interfejsu użytkownika używaną przez Resource Manager do wyszukiwania zasobów specyficznych dla kultury w czasie wykonywania.

DateTimeFormat

Pobiera lub ustawia element DateTimeFormatInfo definiujący kulturowo odpowiedni format wyświetlania dat i godzin.

DefaultThreadCurrentCulture

Pobiera lub ustawia domyślną kulturę wątków w bieżącej domenie aplikacji.

DefaultThreadCurrentUICulture

Pobiera lub ustawia domyślną kulturę interfejsu użytkownika dla wątków w bieżącej domenie aplikacji.

DisplayName

Pobiera pełną zlokalizowaną nazwę kultury.

EnglishName

Pobiera nazwę kultury w formacie languagefull [country/regionfull] w języku angielskim.

IetfLanguageTag

Przestarzałe. Pobiera standardową identyfikację języka RFC 4646.

InstalledUICulture

CultureInfo Pobiera element reprezentujący kulturę zainstalowaną w systemie operacyjnym.

InvariantCulture

CultureInfo Pobiera obiekt niezależny od kultury (niezmienny).

IsNeutralCulture

Pobiera wartość wskazującą, czy bieżący CultureInfo reprezentuje kulturę neutralną.

IsReadOnly

Pobiera wartość wskazującą, czy bieżący CultureInfo jest tylko do odczytu.

KeyboardLayoutId

Pobiera aktywny identyfikator ustawień regionalnych danych wejściowych.

LCID

Pobiera identyfikator kultury dla bieżącego CultureInfoelementu .

Name

Pobiera nazwę kultury w formacie languagecode2-country/regioncode2.

NativeName

Pobiera nazwę kultury składającą się z języka, kraju/regionu i opcjonalnego skryptu, który ma być wyświetlany przez kulturę.

NumberFormat

Pobiera lub ustawia element NumberFormatInfo definiujący kulturowo odpowiedni format wyświetlania liczb, waluty i wartości procentowej.

OptionalCalendars

Pobiera listę kalendarzy, które mogą być używane przez kulturę.

Parent

Pobiera element CultureInfo reprezentujący kulturę nadrzędną bieżącego CultureInfoelementu .

TextInfo

Pobiera element TextInfo definiujący system pisania skojarzony z kulturą.

ThreeLetterISOLanguageName

Pobiera kod ISO 639-2 trzyliterowy dla języka bieżącego CultureInfo.

ThreeLetterWindowsLanguageName

Pobiera trzyliterowy kod języka zgodnie z definicją w interfejsie API systemu Windows.

TwoLetterISOLanguageName

Pobiera dwuliterowy kod ISO 639-1 lub ISO 639-3 trzyliterowy dla języka bieżącego CultureInfo.

UseUserOverride

Pobiera wartość wskazującą, czy bieżący CultureInfo obiekt używa ustawień kultury wybranych przez użytkownika.

Metody

ClearCachedData()

Odświeża buforowane informacje związane z kulturą.

Clone()

Tworzy kopię bieżącego CultureInfoelementu .

CreateSpecificCulture(String)

Tworzy obiekt CultureInfo reprezentujący określoną kulturę skojarzona z określoną nazwą.

Equals(Object)

Określa, czy określony obiekt jest taką samą kulturą jak bieżąca CultureInfo.

GetConsoleFallbackUICulture()

Pobiera alternatywną kulturę interfejsu użytkownika odpowiednią dla aplikacji konsolowych, gdy domyślna kultura graficznego interfejsu użytkownika jest nieodpowiednia.

GetCultureInfo(Int32)

Pobiera buforowane, tylko do odczytu wystąpienie kultury przy użyciu określonego identyfikatora kultury.

GetCultureInfo(String)

Pobiera buforowane, tylko do odczytu wystąpienie kultury przy użyciu określonej nazwy kultury.

GetCultureInfo(String, Boolean)

Pobiera buforowane, tylko do odczytu wystąpienie kultury.

GetCultureInfo(String, String)

Pobiera buforowane, tylko do odczytu wystąpienie kultury. Parametry określają kulturę zainicjowaną za pomocą TextInfo obiektów i CompareInfo określonych przez inną kulturę.

GetCultureInfoByIetfLanguageTag(String)

Przestarzałe. Pobiera obiekt tylko do CultureInfo odczytu o cechach językowych identyfikowanych przez określony tag języka RFC 4646.

GetCultures(CultureTypes)

Pobiera listę obsługiwanych kultur filtrowanych według określonego CultureTypes parametru.

GetFormat(Type)

Pobiera obiekt, który definiuje sposób formatowania określonego typu.

GetHashCode()

Służy jako funkcja skrótu dla bieżącego CultureInfo, odpowiedniego do algorytmów tworzenia skrótów i struktur danych, takich jak tabela skrótów.

GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ReadOnly(CultureInfo)

Zwraca otokę tylko do odczytu wokół określonego CultureInfo obiektu.

ToString()

Zwraca ciąg zawierający nazwę bieżącego CultureInfo elementu w formacie languagecode2-country/regioncode2.

Dotyczy

Zobacz też