CultureInfo.GetCultureInfo Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает кэшированный экземпляр языка и региональных параметров только для чтения.
Перегрузки
| Имя | Описание |
|---|---|
| GetCultureInfo(String, Boolean) |
Извлекает кэшированный экземпляр языка и региональных параметров только для чтения. |
| GetCultureInfo(String, String) |
Извлекает кэшированный экземпляр языка и региональных параметров только для чтения. Параметры указывают язык и региональные параметры, инициализированные с TextInfo помощью объектов, CompareInfo указанных другим языком и региональными параметрами. |
| GetCultureInfo(Int32) |
Извлекает кэшированный экземпляр языка и региональных параметров только для чтения с помощью указанного идентификатора языка и региональных параметров. |
| GetCultureInfo(String) |
Извлекает кэшированный экземпляр только для чтения языка и региональных параметров с помощью указанного имени языка и региональных параметров. |
GetCultureInfo(String, Boolean)
- Исходный код:
- CultureInfo.cs
- Исходный код:
- CultureInfo.cs
- Исходный код:
- 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.CultureInfoPublic Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfoПараметры
- name
- String
Имя языка и региональных параметров. Регистр не учитывается.
- predefinedOnly
- Boolean
true При запросе на создание экземпляра языка и региональных параметров, известного платформой.
false Если это нормально для повторного получения языка и региональных параметров, даже если платформа не несет для нее данные.
Возвращаемое значение
Экземпляр языка и региональных параметров только для чтения.
Комментарии
По умолчанию при попытке создать язык и региональные параметры и базовую платформу (Windows NLS или ICU) не содержит определенных данных для этого языка и региональных параметров, платформа попытается создать язык и региональные параметры с данными из других языков или некоторых постоянных значений.
predefinedOnly Чтобы обеспечить создание языка и региональных параметровtrue, создается только в том случае, если платформа имеет реальные данные для этого языка и региональных параметров.
Применяется к
GetCultureInfo(String, String)
- Исходный код:
- CultureInfo.cs
- Исходный код:
- CultureInfo.cs
- Исходный код:
- 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.CultureInfoPublic Shared Function GetCultureInfo (name As String, altName As String) As CultureInfoПараметры
- name
- String
Имя языка и региональных параметров.
name не учитывает регистр.
- altName
- String
Имя языка и региональных параметров, которые предоставляют TextInfo объекты, CompareInfo используемые для инициализации name.
altName не учитывает регистр.
Возвращаемое значение
Объект только для 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)
- Исходный код:
- CultureInfo.cs
- Исходный код:
- CultureInfo.cs
- Исходный код:
- 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.CultureInfoPublic Shared Function GetCultureInfo (culture As Integer) As CultureInfoПараметры
- culture
- Int32
Идентификатор языка (LCID).
Возвращаемое значение
Объект только для CultureInfo чтения.
Исключения
culture меньше нуля.
culture указывает язык и региональные параметры, которые не поддерживаются. Дополнительные сведения см. в разделе "Заметки для вызывающего абонента".
Комментарии
Рекомендуется использовать строковую перегрузку этого метода (GetCultureInfo(String)), так как имена языкового стандарта должны использоваться вместо LCID. Для пользовательских языковых стандартов требуется имя языкового стандарта.
Если culture является идентификатором языкового стандарта текущего языка и региональных параметров, возвращаемый CultureInfo объект не отражает переопределения пользователя.
Note
LCID являются устаревшими, и реализующие настоятельно рекомендуется использовать более новые версии API, поддерживающие имена языков BCP 47. Каждый LCID может быть представлен именем языкового стандарта BCP 47, но обратное не верно. Диапазон LCID ограничен и не может однозначно определить все возможные сочетания языка и региона.
Примечания для тех, кто вызывает этот метод
.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
- Исходный код:
- 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.CultureInfoPublic Shared Function GetCultureInfo (name As String) As CultureInfoПараметры
- name
- String
Имя языка и региональных параметров.
name не учитывает регистр.
Возвращаемое значение
Объект только для 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 исключение, если name не является допустимым именем языка и региональных параметров. Начиная с .NET Framework 4, этот метод создает CultureNotFoundExceptionисключение. Начиная с приложений, работающих в .NET Framework 4 или более поздней версии в Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор name которого находится из операционной системы; если операционная система не поддерживает этот язык и региональные параметры, а если name не имя дополнительного или заменного языка и региональных параметров, метод вызывает исключение CultureNotFoundException.
В .NET 6 и более поздних версиях создается исключение, CultureNotFoundException если приложение работает в среде, в которой включен режим глобализации и инвариантной среды, например некоторые контейнеры Docker, а также язык и региональные параметры, отличные от инвариантного языка и региональных параметров.
