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.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)
Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения. В параметрах определяется язык и региональные параметры, которые инициализируются вместе с объектами 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 свойства. String.EmptyВ противном случае altName метод использует систему записи и правила сравнения, заданные инвариантным языком и региональными параметрами.
Примечания для тех, кто вызывает этот метод
платформа .NET Framework версии 3.5 и более ранних версий создают исключениеArgumentException, если name или altName не является допустимым именем языка и региональных параметров. Начиная с платформа .NET Framework 4 этот метод создает исключение CultureNotFoundException. Начиная с приложений, которые выполняются в платформа .NET Framework 4 или более поздней версии Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор которого находится name из операционной системы; если операционная система не поддерживает этот язык и name региональные параметры замены, метод создает 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.CultureInfoPublic Shared Function GetCultureInfo (culture As Integer) As CultureInfoПараметры
- culture
- Int32
Идентификатор языка (LCID).
Возвращаемое значение
Объект CultureInfo, доступный только для чтения.
Исключения
Значение параметра culture меньше нуля.
Параметр 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)
Служит для получения кэшированного экземпляра языка и региональных параметров с помощью указанного имени.
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 и язык и региональные параметры, отличные от инвариантного языка и региональных параметров.