CultureInfo.GetCultureInfo Метод

Определение

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.Retrieves a cached, read-only instance of a culture.

Перегрузки

GetCultureInfo(String, Boolean)

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.Retrieves a cached, read-only instance of a culture.

GetCultureInfo(String, String)

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.Retrieves a cached, read-only instance of a culture. В параметрах определяется язык и региональные параметры, которые инициализируются вместе с объектами TextInfo и CompareInfo.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

GetCultureInfo(Int32)

Служит для получения кэшированного доступного только для чтения экземпляра языка и региональных параметров с помощью указанного идентификатора языка и региональных параметров.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

GetCultureInfo(String)

Служит для получения кэшированного экземпляра языка и региональных параметров с помощью указанного имени.Retrieves a cached, read-only instance of a culture using the specified culture name.

GetCultureInfo(String, Boolean)

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.Retrieves a cached, read-only instance of a culture.

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

Имя языка и региональных параметров.The name of a culture. Не учитывает регистр.It is not case-sensitive.

predefinedOnly
Boolean

Имеет значение true, если выполняется запрос на создание экземпляра языка и региональных параметров, известных платформе.true if requesting to create an instance of a culture that is known by the platform. Имеет значение false, если допускается получение созданных языка и региональных параметров, даже если на платформе нет таких данных.false if it is ok to retreive a made-up culture even if the platform does not carry data for it.

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

CultureInfo

Доступный только для чтения экземпляр языка и региональных параметров.A read-only instance of a culture.

Комментарии

По умолчанию при попытке создать какой-либо язык и региональные параметры и базовая платформа (Windows NLS или ICU) не содержит определенных данных для этого языка и региональных параметров, платформа попытается создать язык и региональные параметры с данными из других языков и региональных параметров или некоторых постоянных значений.By default, when trying to create any culture and the underlying platform (Windows NLS or ICU) does not carry specific data for this culture, the platform will try constructing a culture with data from other cultures or some constant values.

Если задано значение, то predefinedOnly true язык и региональные параметры будут создаваться только в том случае, если платформа содержит реальные данные для этого языка и региональных параметров.Setting predefinedOnly to true will ensure a culture is created only if the platform has real data for that culture.

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

GetCultureInfo(String, String)

Служит для получения кешированного экземпляра языка и региональных параметров, доступного только для чтения.Retrieves a cached, read-only instance of a culture. В параметрах определяется язык и региональные параметры, которые инициализируются вместе с объектами TextInfo и CompareInfo.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

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

Имя языка и региональных параметров.The name of a culture. name не учитывает регистр.name is not case-sensitive.

altName
String

Имя языка и региональных параметров, предоставляющих объекты TextInfo и CompareInfo для инициализации параметра name.The name of a culture that supplies the TextInfo and CompareInfo objects used to initialize name. altName не учитывает регистр.altName is not case-sensitive.

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

CultureInfo

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

Исключения

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

Параметры name или altName указывает не поддерживаемый язык и региональные параметры.name or altName specifies a culture that is not supported. Дополнительные сведения см. в разделе "Примечания для вызывающей стороны".See the Notes to Callers section for more information.

Комментарии

Список предварительно определенных имен языков и региональных параметров в системах Windows см. в столбце тег языка в списке имен языков и регионов, поддерживаемых Windows.For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. Теги языков указаны в соответствии со стандартом BCP 47.Culture names follow the standard defined by BCP 47. Кроме того, начиная с Windows 10 name может быть любой допустимый тег языка BCP-47.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

GetCultureInfoМетод получает кэшированный объект только для чтения CultureInfo .The GetCultureInfo method obtains a cached, read-only CultureInfo object. Он обеспечивает лучшую производительность, чем соответствующий вызов CultureInfo конструктора.It offers better performance than a corresponding call to a CultureInfo constructor. Метод используется для создания языка и региональных параметров, сходных с параметрами, заданными name параметром, но с различными правилами сортировки и учета регистра.The method is used to create a culture similar to that specified by the name parameter, but with different sorting and casing rules.

Если name или altName — имя текущего языка и региональных параметров, то возвращаемые объекты не отразит какие-либо переопределения пользователя.If name or altName is the name of the current culture, the returned objects do not reflect any user overrides. Если name имеет значение String.Empty , метод возвращает инвариантный язык и региональные параметры.If name is String.Empty, the method returns the invariant culture. Это эквивалентно извлечению значения InvariantCulture Свойства.This is equivalent to retrieving the value of the InvariantCulture property. Если altName параметр имеет значение String.Empty , то метод использует систему записи и правила сравнения, заданные инвариантным языком и региональными параметрами.If altName is String.Empty, the method uses the writing system and comparison rules specified by the invariant culture.

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

.NET Framework 3,5.NET Framework 3.5И более ранние версии вызывают исключение ArgumentException if или не name altName является допустимым именем языка и региональных параметров.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name or altName is not a valid culture name. Начиная с .NET Framework 4.NET Framework 4 , этот метод создает исключение CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Начиная с приложений, которые работают в .NET Framework 4.NET Framework 4 или более поздней версии в Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор которого находится name в операционной системе; если операционная система не поддерживает этот язык и региональные параметры, а не name является именем дополнительной или заменяющей культуры, метод создает CultureNotFoundException исключение.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception. Начиная с приложений, которые работают в .NET Framework 4.NET Framework 4 или более поздней версии в Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор которого находится name в операционной системе; если операционная система не поддерживает этот язык и региональные параметры, а не name является именем дополнительной или заменяющей культуры, метод создает CultureNotFoundException исключение.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception.

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

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

GetCultureInfo(Int32)

Служит для получения кэшированного доступного только для чтения экземпляра языка и региональных параметров с помощью указанного идентификатора языка и региональных параметров.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

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).A locale identifier (LCID).

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

CultureInfo

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

Исключения

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

Параметр culture указывает не поддерживаемый язык и региональные параметры.culture specifies a culture that is not supported. Дополнительные сведения см. в разделе "Примечания к вызывающим объектам".See the Notes to Caller section for more information.

Комментарии

Рекомендуется использовать перегрузку строк этого метода ( GetCultureInfo(String) ), поскольку вместо LCID следует использовать имена языковых стандартов.We recommend that you use the string overload of this method (GetCultureInfo(String)), because locale names should be used instead of LCIDs. Для пользовательских языковых стандартов требуется указать имя локали.For custom locales, the locale name is required.

Если culture — это идентификатор локали текущего языка и региональных параметров, возвращаемый CultureInfo объект не отражает никаких переопределений пользователя.If culture is the locale identifier of the current culture, the returned CultureInfo object does not reflect any user overrides.

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

.NET Framework 3,5.NET Framework 3.5И более ранние версии вызывают исключение, ArgumentException если не culture является допустимым идентификатором языка и региональных параметров.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. Начиная с .NET Framework 4.NET Framework 4 , этот метод создает исключение CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Начиная с приложений, которые работают в .NET Framework 4.NET Framework 4 или более поздней версии в Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор которого находится culture в операционной системе. Если операционная система не поддерживает этот язык, метод создает исключение CultureNotFoundException .Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is culture from the operating system; if the operating system does not support that culture, the method throws a CultureNotFoundException.

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

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

GetCultureInfo(String)

Служит для получения кэшированного экземпляра языка и региональных параметров с помощью указанного имени.Retrieves a cached, read-only instance of a culture using the specified culture name.

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

Имя языка и региональных параметров.The name of a culture. name не учитывает регистр.name is not case-sensitive.

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

CultureInfo

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

Исключения

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

name указывает язык и региональные параметры, которые не поддерживаются.name specifies a culture that is not supported. Дополнительные сведения см. в разделе "Примечания для вызывающей стороны".See the Notes to Callers section for more information.

Комментарии

Список предварительно определенных имен языков и региональных параметров в системах Windows см. в столбце тег языка в списке имен языков и регионов, поддерживаемых Windows.For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. Теги языков указаны в соответствии со стандартом BCP 47.Culture names follow the standard defined by BCP 47. Кроме того, начиная с Windows 10 name может быть любой допустимый тег языка BCP-47.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

GetCultureInfoМетод извлекает кэшированный объект, доступный только для чтения CultureInfo .The GetCultureInfo method retrieves a cached, read-only CultureInfo object. Он обеспечивает лучшую производительность, чем соответствующий вызов CultureInfo.CultureInfo(String) конструктора.It offers better performance than a corresponding call to the CultureInfo.CultureInfo(String) constructor.

Если name — имя текущего языка и региональных параметров, возвращаемый CultureInfo объект не отражает никаких переопределений пользователя.If name is the name of the current culture, the returned CultureInfo object does not reflect any user overrides. Это делает метод пригодным для серверных приложений или средств, которые не имеют реальной учетной записи пользователя в системе и должны эффективно загружать несколько культур.This makes the method suitable for server applications or tools that do not have a real user account on the system and that need to load multiple cultures efficiently.

Если name имеет значение String.Empty , метод возвращает инвариантный язык и региональные параметры.If name is String.Empty, the method returns the invariant culture. Это эквивалентно извлечению значения InvariantCulture Свойства.This is equivalent to retrieving the value of the InvariantCulture property.

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

.NET Framework 3,5.NET Framework 3.5И более ранние версии вызывают исключение, ArgumentException если не name является допустимым именем языка и региональных параметров.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. Начиная с .NET Framework 4.NET Framework 4 , этот метод создает исключение CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Начиная с приложений, которые работают в .NET Framework 4.NET Framework 4 или более поздней версии в Windows 7 или более поздней версии, метод пытается получить CultureInfo объект, идентификатор которого получен name из операционной системы; если операционная система не поддерживает этот язык и региональные параметры, а не name является именем дополнительной или замещающей культуры, метод создает исключение CultureNotFoundException .Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException.

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

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