CultureInfo.GetCultureInfo Метод

Определение

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.

Перегрузки

GetCultureInfo(String, Boolean)

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.

GetCultureInfo(String, String)

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

GetCultureInfo(Int32)

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

GetCultureInfo(String)

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

GetCultureInfo(String, Boolean)

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, bool predefinedOnly);
public static System.Globalization.CultureInfo GetCultureInfo (string name, bool predefinedOnly);
static member GetCultureInfo : string * bool -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfo

Параметры

name
String

Имя языка и региональных параметров. Не учитывает регистр.

predefinedOnly
Boolean

Имеет значение true, если выполняется запрос на создание экземпляра языка и региональных параметров, известных платформе. Имеет значение false, если допускается получение созданных языка и региональных параметров, даже если на платформе нет таких данных.

Возвращаемое значение

CultureInfo

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

Комментарии

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

При установке predefinedOnly параметра значение true гарантируется, что язык и региональные параметры будут созданы только в том случае, если платформа содержит реальные данные для этого языка.

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

GetCultureInfo(String, String)

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

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, System::String ^ altName);
public static System.Globalization.CultureInfo GetCultureInfo (string name, string altName);
static member GetCultureInfo : string * string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String, altName As String) As CultureInfo

Параметры

name
String

Имя языка и региональных параметров. name не учитывает регистр.

altName
String

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

Возвращаемое значение

CultureInfo

Объект CultureInfo, доступный только для чтения.

Исключения

name или altName равно null.

Параметры name или altName указывает не поддерживаемый язык и региональные параметры. Дополнительные сведения см. в разделе "Примечания для вызывающей стороны".

Комментарии

Список стандартных имен языка и региональных параметров в системах Windows см. в столбце Языковой тег в списке имен языков или регионов, поддерживаемых Windows. Теги языков указаны в соответствии со стандартом BCP 47. Кроме того, начиная с Windows 10, name может быть любым допустимым тегом языка BCP-47.

Метод GetCultureInfo получает кэшированный объект, доступный только для CultureInfo чтения. Он обеспечивает лучшую производительность, чем соответствующий вызов конструктора CultureInfo . Метод используется для создания языка и региональных параметров, аналогичных языку, заданному name параметром , но с разными правилами сортировки и регистра.

Если name или altName является именем текущего языка и региональных параметров, возвращаемые объекты не отражают никаких переопределений пользователей. Если name имеет значение String.Empty, метод возвращает инвариантный язык и региональные параметры. Это эквивалентно получению значения InvariantCulture свойства . Если altName имеет значение String.Empty, метод использует систему записи и правила сравнения, заданные инвариантным языком и региональными параметрами.

Примечания для тех, кто вызывает этот метод

платформа .NET Framework 3.5 и более ранних версий вызывает исключение , ArgumentException если name или altName не является допустимым именем языка и региональных параметров. Начиная с платформа .NET Framework 4, этот метод вызывает исключение CultureNotFoundException. Начиная с приложений, работающих под управлением платформа .NET Framework 4 или более поздней версии в Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор которого находится name в операционной системе; если операционная система не поддерживает этот язык и региональные параметры, а если name не является именем дополнительного или заменяющего языка и региональных параметров, метод создает CultureNotFoundException исключение.

В .NET 6 и более поздних версиях возникает исключение , если приложение выполняется в среде, CultureNotFoundException где включен инвариантный режим глобализации, например некоторые контейнеры Docker, и указывается язык и региональные параметры, отличные от инвариантного языка и региональных параметров.

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

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

GetCultureInfo(Int32)

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

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(int culture);
public static System.Globalization.CultureInfo GetCultureInfo (int culture);
static member GetCultureInfo : int -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (culture As Integer) As CultureInfo

Параметры

culture
Int32

Идентификатор языка (LCID).

Возвращаемое значение

CultureInfo

Объект CultureInfo, доступный только для чтения.

Исключения

Значение параметра culture меньше нуля.

Параметр culture указывает не поддерживаемый язык и региональные параметры. Дополнительные сведения см. в разделе "Примечания к вызывающим объектам".

Комментарии

Рекомендуется использовать строковую перегрузку этого метода (GetCultureInfo(String)), так как вместо LCID следует использовать имена языкового стандарта. Для пользовательских языковых стандартов необходимо указать имя языкового стандарта.

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

Примечания для тех, кто вызывает этот метод

платформа .NET Framework 3.5 и более ранних версий ArgumentException вызывает исключение if culture не является допустимым идентификатором языка и региональных параметров. Начиная с платформа .NET Framework 4, этот метод вызывает исключение CultureNotFoundException. Начиная с приложений, работающих под управлением платформа .NET Framework 4 или более поздней версии в Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор которого находится culture в операционной системе. Если операционная система не поддерживает этот язык и региональные параметры, метод создает CultureNotFoundExceptionисключение .

В .NET 6 и более поздних версиях возникает исключение , если приложение выполняется в среде, CultureNotFoundException где включен инвариантный режим глобализации, например некоторые контейнеры Docker, и указывается язык и региональные параметры, отличные от инвариантного языка и региональных параметров.

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

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

GetCultureInfo(String)

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

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name);
public static System.Globalization.CultureInfo GetCultureInfo (string name);
static member GetCultureInfo : string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String) As CultureInfo

Параметры

name
String

Имя языка и региональных параметров. name не учитывает регистр.

Возвращаемое значение

CultureInfo

Объект CultureInfo, доступный только для чтения.

Исключения

Параметр name имеет значение null.

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

Комментарии

Список стандартных имен языка и региональных параметров в системах Windows см. в столбце Языковой тег в списке имен языков или регионов, поддерживаемых Windows. Теги языков указаны в соответствии со стандартом BCP 47. Кроме того, начиная с Windows 10, name может быть любым допустимым тегом языка BCP-47.

Метод GetCultureInfo извлекает кэшированный объект, доступный только для CultureInfo чтения. Он обеспечивает лучшую производительность, чем соответствующий вызов конструктора CultureInfo.CultureInfo(String) .

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

Если name имеет значение String.Empty, метод возвращает инвариантный язык и региональные параметры. Это эквивалентно получению значения InvariantCulture свойства .

Примечания для тех, кто вызывает этот метод

платформа .NET Framework 3.5 и более ранних версий ArgumentException вызывает исключение if name не является допустимым именем языка и региональных параметров. Начиная с платформа .NET Framework 4, этот метод вызывает исключение CultureNotFoundException. Начиная с приложений, работающих под управлением платформа .NET Framework 4 или более поздней версии в Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор которого находится name в операционной системе; если операционная система не поддерживает этот язык и региональные параметры и региональные параметры не поддерживаются, а если name не является именем дополнительного или заменяющего языка и региональных параметров, метод вызывает CultureNotFoundExceptionисключение .

В .NET 6 и более поздних версиях возникает исключение , если приложение выполняется в среде, CultureNotFoundException где включен инвариантный режим глобализации, например некоторые контейнеры Docker, и указывается язык и региональные параметры, отличные от инвариантного языка и региональных параметров.

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

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