CultureInfo Класс

Определение

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

public ref class CultureInfo : IFormatProvider
public ref class CultureInfo : ICloneable, IFormatProvider
public class CultureInfo : IFormatProvider
[System.Serializable]
public class CultureInfo : ICloneable, IFormatProvider
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class CultureInfo : ICloneable, IFormatProvider
public class CultureInfo : ICloneable, IFormatProvider
type CultureInfo = class
    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
type CultureInfo = class
    interface ICloneable
    interface IFormatProvider
Public Class CultureInfo
Implements IFormatProvider
Public Class CultureInfo
Implements ICloneable, IFormatProvider
Наследование
CultureInfo
Атрибуты
Реализации

Комментарии

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

Пример

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

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

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

Имя Описание
CultureInfo(Int32, Boolean)

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

CultureInfo(Int32)

Инициализирует новый экземпляр CultureInfo класса на основе языка и региональных параметров, указанного идентификатором языка и региональных параметров.

CultureInfo(String, Boolean)

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

CultureInfo(String)

Инициализирует новый экземпляр CultureInfo класса на основе языка и региональных параметров, указанных по имени.

Свойства

Имя Описание
Calendar

Возвращает календарь по умолчанию, используемый языком и региональными параметрами.

CompareInfo

Возвращает значение, определяющее CompareInfo , как сравнивать строки для языка и региональных параметров.

CultureTypes

Возвращает типы языка и региональных параметров, относящиеся к текущему CultureInfo объекту.

CurrentCulture

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

CurrentUICulture

Возвращает или задает объект CultureInfo, представляющий текущий язык и региональные параметры пользовательского интерфейса, используемые Resource Manager для поиска ресурсов, относящихся к языку и региональных параметров во время выполнения.

DateTimeFormat

Возвращает или задает объект, DateTimeFormatInfo определяющий культурный формат отображения дат и времени.

DefaultThreadCurrentCulture

Возвращает или задает язык и региональные параметры по умолчанию для потоков в текущем домене приложения.

DefaultThreadCurrentUICulture

Возвращает или задает язык и региональные параметры пользовательского интерфейса по умолчанию для потоков в текущем домене приложения.

DisplayName

Возвращает полное локализованное имя языка и региональных параметров.

EnglishName

Возвращает имя языка и региональных параметров в формате languagefull [country/regionfull] на английском языке.

IetfLanguageTag

Deprecated. Возвращает стандартную идентификацию 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

Получает трехбуквенный код для языка, как определено в API Windows.

TwoLetterISOLanguageName

Получает двухбуквенный код ISO 639-1 или ISO 639-3 с тремя буквами для языка текущего CultureInfo.

UseUserOverride

Возвращает значение, указывающее, использует ли текущий CultureInfo объект параметры языка и региональных параметров, выбранных пользователем.

Методы

Имя Описание
ClearCachedData()

Обновляет кэшированные сведения о языках и региональных параметрах.

Clone()

Создает копию текущей CultureInfo.

CreateSpecificCulture(String)

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

Equals(Object)

Определяет, является ли указанный объект тем же языком и региональными параметрами, что и текущий CultureInfo.

GetConsoleFallbackUICulture()

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

GetCultureInfo(Int32)

Извлекает кэшированный экземпляр языка и региональных параметров только для чтения с помощью указанного идентификатора языка и региональных параметров.

GetCultureInfo(String, String)

Извлекает кэшированный экземпляр языка и региональных параметров только для чтения. Параметры указывают язык и региональные параметры, инициализированные с TextInfo помощью объектов, CompareInfo указанных другим языком и региональными параметрами.

GetCultureInfo(String)

Извлекает кэшированный экземпляр только для чтения языка и региональных параметров с помощью указанного имени языка и региональных параметров.

GetCultureInfoByIetfLanguageTag(String)

Deprecated. Извлекает объект только для CultureInfo чтения с лингвистическими характеристиками, определяемыми указанным тегом языка RFC 4646.

GetCultures(CultureTypes)

Возвращает список поддерживаемых языков и региональных параметров, отфильтрованных указанным CultureTypes параметром.

GetFormat(Type)

Возвращает объект, определяющий форматирование указанного типа.

GetHashCode()

Служит хэш-функцией для текущего CultureInfo, подходящего для хэширования алгоритмов и структур данных, таких как хэш-таблица.

GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
ReadOnly(CultureInfo)

Возвращает оболочку только для чтения вокруг указанного CultureInfo объекта.

ToString()

Возвращает строку, содержащую имя текущего CultureInfo в формате languagecode2-country/regioncode2.

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

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