CultureInfo Класс

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Исходный код:

CultureInfo.cs

Предоставляет сведения об определенном языке и региональных параметрах (которые в совокупности называются языковым стандартом для разработки неуправляемого кода). Эти сведения включают имена языков и региональных параметров, систему письма, используемый календарь, порядок сортировки строк и форматы дат и чисел.

C#

public class CultureInfo : ICloneable, IFormatProvider

Наследование

Object

CultureInfo

Реализации

IFormatProvider ICloneable

Примеры

В следующем примере показано, как создать CultureInfo объект для испанского языка (Испания) с международной сортировкой и другой CultureInfo объект с традиционной сортировкой.

C#

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

*/

Комментарии

Дополнительные сведения об этом API см. в разделе Дополнительные примечания API для CultureInfo.

Конструкторы

CultureInfo(Int32)	Инициализирует новый экземпляр класса CultureInfo на основе языка и региональных параметров, заданных идентификатором.
CultureInfo(Int32, Boolean)	Инициализирует новый экземпляр CultureInfo класса на основе языка и региональных параметров, заданных идентификатором языка и региональных параметров, и значения, указывающего, следует ли использовать выбранные пользователем параметры языка и региональных параметров из Windows.
CultureInfo(String)	Инициализирует новый экземпляр класса CultureInfo на основе языка и региональных параметров, заданных именем.
CultureInfo(String, Boolean)	Инициализирует новый экземпляр CultureInfo класса на основе языка и региональных параметров, заданных именем, и значения, указывающего, следует ли использовать выбранные пользователем параметры языка и региональных параметров из Windows.

Свойства

Calendar	Возвращает календарь, используемый по умолчанию для языка и региональных параметров.
CompareInfo	Возвращает объект CompareInfo, который определяет способ сравнения строк в данном языке и региональных параметрах.
CultureTypes	Возвращает типы языков и региональных параметров, относящихся к текущему объекту CultureInfo.
CurrentCulture	Возвращает или задает CultureInfo объект , представляющий язык и региональные параметры, используемые текущим потоком и асинхронными операциями на основе задач.
CurrentUICulture	Возвращает или задает объект CultureInfo, представляющий текущий язык и региональные параметры пользовательского интерфейса, используемые диспетчером ресурсов для поиска ресурсов, связанных с конкретным языком и региональными параметрами, во время выполнения.
DateTimeFormat	Возвращает или задает DateTimeFormatInfo, определяющий формат отображения даты и времени, соответствующий языку и региональным параметрам.
DefaultThreadCurrentCulture	Возвращает или задает язык и региональные параметры, используемые по умолчанию для потоков в текущем домене приложения.
DefaultThreadCurrentUICulture	Возвращает или задает язык и региональные параметры пользовательского интерфейса, используемые по умолчанию для потоков в текущем домене приложения.
DisplayName	Возвращает полное локализованное имя языка и региональных параметров.
EnglishName	Возвращает имя языка и региональных параметров в формате languagefull [country/regionfull] на английском языке.
IetfLanguageTag	Не рекомендуется. Получает идентификацию языка по стандарту RFC 4646.
InstalledUICulture	Возвращает объект CultureInfo, представляющий язык и региональные параметры, установленные с операционной системой.
InvariantCulture	Возвращает объект CultureInfo, не зависящий от языка и региональных параметров (инвариантный).
IsNeutralCulture	Возвращает значение, показывающее, представляет ли текущий объект CultureInfo нейтральный язык и региональные параметры.
IsReadOnly	Возвращает значение, указывающее, является ли текущий объект CultureInfo доступным только для чтения.
KeyboardLayoutId	Получает активный идентификатор языка ввода.
LCID	Возвращает идентификатор языка и региональных параметров для текущего объекта CultureInfo.
Name	Возвращает имя языка и региональных параметров в формате languagecode2-country/regioncode2.
NativeName	Получает имя языка и региональных параметров, состоящих из языка, страны или региона и дополнительного набора символов, которые свойственны для этого языка.
NumberFormat	Возвращает или задает объект NumberFormatInfo, определяющий формат отображения чисел, денежной единицы и процентов, соответствующий языку и региональным параметрам.
OptionalCalendars	Возвращает список календарей, которые могут использоваться в данном языке и региональных параметров.
Parent	Возвращает объект CultureInfo, представляющий родительский язык и региональные параметры текущего объекта CultureInfo.
TextInfo	Возвращает значение TextInfo, определяющее систему письма, связанную с данным языком и региональными параметрами.
ThreeLetterISOLanguageName	Возвращает трехбуквенный код ISO 639-2 для языка текущего объекта CultureInfo.
ThreeLetterWindowsLanguageName	Возвращает трехбуквенный код для языка, определенный в формате Windows API.
TwoLetterISOLanguageName	Возвращает двухбуквенный код ISO 639-1 или трехбуквенный код ISO 639-3 для языка текущего CultureInfo.
UseUserOverride	Получает значение, которое указывает, использует ли текущий объект CultureInfo параметры языка и региональных параметров, выбранные пользователем.

Методы

ClearCachedData()	Обновляет кешированные данные, связанные с языком и региональными параметрами.
Clone()	Создает копию текущего поставщика CultureInfo.
CreateSpecificCulture(String)	Создает объект CultureInfo, который представляет определенный язык и региональные параметры, соответствующие заданному имени.
Equals(Object)	Определяет, является ли заданный объект тем же языком и региональными параметрами, что и текущий CultureInfo.
GetConsoleFallbackUICulture()	Получает язык и региональные стандарты интерфейса пользователя, подходящие для приложений консоли, если при этом неприменим язык и региональные стандарты графического пользовательского интерфейса по умолчанию.
GetCultureInfo(Int32)	Служит для получения кэшированного доступного только для чтения экземпляра языка и региональных параметров с помощью указанного идентификатора языка и региональных параметров.
GetCultureInfo(String)	Служит для получения кэшированного экземпляра языка и региональных параметров с помощью указанного имени.
GetCultureInfo(String, Boolean)	Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.
GetCultureInfo(String, String)	Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения. В параметрах определяется язык и региональные параметры, которые инициализируются вместе с объектами TextInfo и CompareInfo.
GetCultureInfoByIetfLanguageTag(String)	Не рекомендуется. Служит для получения объекта CultureInfo, доступного только для чтения, который имеет языковые характеристики, указываемые определенным языковым тегом RFC 4646.
GetCultures(CultureTypes)	Возвращает список поддерживаемых языков и региональных параметров, отфильтрованный по заданным значениям параметра CultureTypes.
GetFormat(Type)	Возвращает объект, определяющий способ форматирования заданного типа.
GetHashCode()	Служит хэш-функцией текущего класса CultureInfo для использования в алгоритмах и структурах данных хеширования, например в хэш-таблице.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ReadOnly(CultureInfo)	Возвращает доступную только для чтения программу-оболочку для заданного объекта CultureInfo.
ToString()	Возвращает строку, содержащую имя текущего объекта CultureInfo в формате languagecode2-country/regioncode2.

Применяется к

См. также раздел

• CultureAndRegionInfoBuilder
• RegionInfo