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

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

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

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