CultureInfo.GetCultureInfo Метод

Определение

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

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, доступный только для чтения.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, доступный только для чтения.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.

Дополнительно

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, доступный только для чтения.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 если 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.

Дополнительно

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