CultureInfo.GetCultureInfo Метод

Исходный код:

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

Параметры

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

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

Комментарии

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

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

Исходный код:

CultureInfo.cs

Исходный код:

CultureInfo.cs

Исходный код:

CultureInfo.cs

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

Параметры

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

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

Исключения

Комментарии

Список стандартных имен языка и региональных параметров в системах 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, и указан язык и региональные параметры, отличные от инвариантного языка и региональных параметров.

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

• Name
• ClearCachedData()

Исходный код:

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

Параметры

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

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

Исключения

Комментарии

Рекомендуется использовать перегрузку строки этого метода (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, и указан язык и региональные параметры, отличные от инвариантного языка и региональных параметров.

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

• LCID
• ClearCachedData()

Исходный код:

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

Параметры

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

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

Исключения

Комментарии

Список стандартных имен языка и региональных параметров в системах 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, и указан язык и региональные параметры, отличные от инвариантного языка и региональных параметров.

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

• Name