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

Definición

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural.Retrieves a cached, read-only instance of a culture.

Sobrecargas

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

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural usando el identificador de referencia cultural especificado.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

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

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural utilizando el nombre de referencia cultural especificado.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)

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural.Retrieves a cached, read-only instance of a culture. Los parámetros especifican una referencia cultural que se inicializa con los objetos TextInfo y CompareInfo especificados por otra referencia cultural.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)

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural usando el identificador de referencia cultural especificado.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

Parámetros

culture
Int32 Int32 Int32 Int32

Identificador de configuración regional (LCID).A locale identifier (LCID).

Devoluciones

Un objeto CultureInfo de solo lectura.A read-only CultureInfo object.

Excepciones

culture especifica una referencia cultural que no se admite.culture specifies a culture that is not supported. Para obtener más información, vea la sección Notas para los autores de llamada.See the Notes to Caller section for more information.

Comentarios

Se recomienda usar la sobrecarga de cadena de este método (GetCultureInfo(String)), ya que los nombres de configuración regional deben usarse en lugar de LCID.We recommend that you use the string overload of this method (GetCultureInfo(String)), because locale names should be used instead of LCIDs. En el caso de las configuraciones regionales personalizadas, se requiere el nombre de la configuración regional.For custom locales, the locale name is required.

Si culture es el identificador de configuración regional de la referencia cultural actual, el CultureInfo objeto devuelto no refleja ninguna invalidación del usuario.If culture is the locale identifier of the current culture, the returned CultureInfo object does not reflect any user overrides.

Notas a los autores de las llamadas

Y las versiones anteriores producen una ArgumentException si culture no es un identificador de referencia cultural válido. .NET Framework 3,5.NET Framework 3.5The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. A partir CultureNotFoundExceptionde ,estemétodo.NET Framework 4.NET Framework 4produce una excepción.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. A partir de las .NET Framework 4.NET Framework 4 aplicaciones que se ejecutan en o versiones posteriores en Windows 7 o versiones posteriores, el método intenta recuperar un CultureInfo objeto culture cuyo identificador es el sistema operativo; Si el sistema operativo no admite esa referencia cultural, el el método produce una CultureNotFoundExceptionexcepción.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.

Consulte también:

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

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural utilizando el nombre de referencia cultural especificado.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

Parámetros

name
String String String String

Nombre de una referencia cultural.The name of a culture. name no distingue entre mayúsculas y minúsculas.name is not case-sensitive.

Devoluciones

Un objeto CultureInfo de solo lectura.A read-only CultureInfo object.

Excepciones

name especifica una referencia cultural que no se admite.name specifies a culture that is not supported. Vea la sección Notas para los llamadores para obtener más información.See the Notes to Callers section for more information.

Comentarios

Para obtener una lista de los nombres de referencias culturales predefinidos en los sistemas Windows, vea la columna etiqueta de idioma en la lista de nombres de idioma o región admitidos por 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. Los nombres de las referencias culturales siguen el estándar definido por BCP 47.Culture names follow the standard defined by BCP 47. Además, a partir de Windows 10, name puede ser cualquier etiqueta de idioma BCP-47 válida.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

El GetCultureInfo método recupera un objeto almacenado en memoria caché y de CultureInfo solo lectura.The GetCultureInfo method retrieves a cached, read-only CultureInfo object. Ofrece un mejor rendimiento que una llamada correspondiente al CultureInfo.CultureInfo(String) constructor.It offers better performance than a corresponding call to the CultureInfo.CultureInfo(String) constructor.

Si name es el nombre de la referencia cultural actual, el CultureInfo objeto devuelto no refleja ninguna invalidación del usuario.If name is the name of the current culture, the returned CultureInfo object does not reflect any user overrides. Esto hace que el método sea adecuado para las aplicaciones de servidor o las herramientas que no tienen una cuenta de usuario real en el sistema y que necesitan cargar varias referencias culturales de forma eficaz.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.

Si name esString.Empty, el método devuelve la referencia cultural de todos los idiomas.If name is String.Empty, the method returns the invariant culture. Esto es equivalente a recuperar el valor de la InvariantCulture propiedad.This is equivalent to retrieving the value of the InvariantCulture property.

Notas a los autores de las llamadas

Y las versiones anteriores producen una ArgumentException si name no es un nombre de referencia cultural válido. .NET Framework 3,5.NET Framework 3.5The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. A partir CultureNotFoundExceptionde ,estemétodo.NET Framework 4.NET Framework 4produce una excepción.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. A partir de las .NET Framework 4.NET Framework 4 aplicaciones que se ejecutan en o versiones posteriores en Windows 7 o versiones posteriores, el método intenta recuperar un CultureInfo objeto name cuyo identificador es el sistema operativo; Si el sistema operativo no admite esa referencia cultural, y si no es el nombre de una referencia cultural complementaria o de reemplazo, el método produce una CultureNotFoundExceptionexcepción. nameStarting 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.

Consulte también:

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

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural.Retrieves a cached, read-only instance of a culture. Los parámetros especifican una referencia cultural que se inicializa con los objetos TextInfo y CompareInfo especificados por otra referencia cultural.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

Parámetros

name
String String String String

Nombre de una referencia cultural.The name of a culture. name no distingue entre mayúsculas y minúsculas.name is not case-sensitive.

altName
String String String String

Nombre de una referencia cultural que proporciona los objetos TextInfo y CompareInfo utilizados para inicializar name.The name of a culture that supplies the TextInfo and CompareInfo objects used to initialize name. altName no distingue entre mayúsculas y minúsculas.altName is not case-sensitive.

Devoluciones

Un objeto CultureInfo de solo lectura.A read-only CultureInfo object.

Excepciones

name o altName especifica una referencia cultural que no se admite.name or altName specifies a culture that is not supported. Vea la sección Notas para los llamadores para obtener más información.See the Notes to Callers section for more information.

Comentarios

Para obtener una lista de los nombres de referencias culturales predefinidos en los sistemas Windows, vea la columna etiqueta de idioma en la lista de nombres de idioma o región admitidos por 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. Los nombres de las referencias culturales siguen el estándar definido por BCP 47.Culture names follow the standard defined by BCP 47. Además, a partir de Windows 10, name puede ser cualquier etiqueta de idioma BCP-47 válida.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

El GetCultureInfo método obtiene un objeto almacenado en memoria caché y de CultureInfo solo lectura.The GetCultureInfo method obtains a cached, read-only CultureInfo object. Ofrece un mejor rendimiento que una llamada correspondiente a un CultureInfo constructor.It offers better performance than a corresponding call to a CultureInfo constructor. El método se utiliza para crear una referencia cultural similar a la especificada por name el parámetro, pero con diferentes reglas de ordenación y uso de mayúsculas y minúsculas.The method is used to create a culture similar to that specified by the name parameter, but with different sorting and casing rules.

Si name oaltName es el nombre de la referencia cultural actual, los objetos devueltos no reflejan las invalidaciones de usuario.If name or altName is the name of the current culture, the returned objects do not reflect any user overrides. Si name esString.Empty, el método devuelve la referencia cultural de todos los idiomas.If name is String.Empty, the method returns the invariant culture. Esto es equivalente a recuperar el valor de la InvariantCulture propiedad.This is equivalent to retrieving the value of the InvariantCulture property. Si altName esString.Empty, el método utiliza el sistema de escritura y las reglas de comparación especificadas por la referencia cultural de todos los idiomas.If altName is String.Empty, the method uses the writing system and comparison rules specified by the invariant culture.

Notas a los autores de las llamadas

Y las versiones anteriores producen una ArgumentException si name o altName no es un nombre de referencia cultural válido. .NET Framework 3,5.NET Framework 3.5The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name or altName is not a valid culture name. A partir CultureNotFoundExceptionde ,estemétodo.NET Framework 4.NET Framework 4produce una excepción.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. A partir de las .NET Framework 4.NET Framework 4 aplicaciones que se ejecutan en o versiones posteriores en Windows 7 o versiones posteriores, el método intenta recuperar un CultureInfo objeto name cuyo identificador es el sistema operativo; Si el sistema operativo no admite esa referencia cultural, y si no es el nombre de una referencia cultural complementaria o de reemplazo, el método produce una CultureNotFoundException excepción. nameStarting 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. A partir de las .NET Framework 4.NET Framework 4 aplicaciones que se ejecutan en o versiones posteriores en Windows 7 o versiones posteriores, el método intenta recuperar un CultureInfo objeto name cuyo identificador es el sistema operativo; Si el sistema operativo no admite esa referencia cultural, y si no es el nombre de una referencia cultural complementaria o de reemplazo, el método produce una CultureNotFoundException excepción. nameStarting 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.

Consulte también:

Se aplica a