Поделиться через

CultureInfo.GetCultureInfo Метод

  • Ссылка

Определение

Пространство имен:
System.Globalization
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

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

Перегрузки

GetCultureInfo(String, Boolean)

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

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

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

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

GetCultureInfo(String, Boolean)

Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs

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

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)

Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения. В параметрах определяется язык и региональные параметры, которые инициализируются вместе с объектами 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, доступный только для чтения.

Исключения

ArgumentNullException

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

CultureNotFoundException

Параметры 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)

Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs

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

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, доступный только для чтения.

Исключения

ArgumentOutOfRangeException

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

CultureNotFoundException

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

Комментарии

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

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

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

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

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

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

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

GetCultureInfo(String)

Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs

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

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, доступный только для чтения.

Исключения

ArgumentNullException

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

CultureNotFoundException

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 , если name не является допустимым именем языка и региональных параметров. Начиная с .NET Framework 4, этот метод вызывает исключение CultureNotFoundException. Начиная с приложений, работающих в .NET Framework 4 или более поздней версии в Windows 7 или более поздних версиях, метод пытается получить CultureInfo объект, идентификатор которого находится name в операционной системе. Если операционная система не поддерживает этот язык и региональные параметры и региональные параметры, если name не является именем дополнительного или замещающего языка и региональных параметров, метод вызывает CultureNotFoundExceptionисключение .

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

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

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