CultureInfo.GetCultureInfo CultureInfo.GetCultureInfo CultureInfo.GetCultureInfo CultureInfo.GetCultureInfo Method

Определение

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

Перегрузки

GetCultureInfo(Int32) GetCultureInfo(Int32) GetCultureInfo(Int32) GetCultureInfo(Int32)

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

GetCultureInfo(String) GetCultureInfo(String) GetCultureInfo(String) GetCultureInfo(String)

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

GetCultureInfo(String, String) GetCultureInfo(String, String) GetCultureInfo(String, String) 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) GetCultureInfo(Int32) GetCultureInfo(Int32) 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 Int32 Int32 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) GetCultureInfo(String) GetCultureInfo(String) 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 String String 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) GetCultureInfo(String, String) GetCultureInfo(String, String) 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 String String String

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

altName
String String String 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.

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

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