CultureInfo.GetCultureInfo Método

Referencia

Definición

Espacio de nombres:: System.Globalization

Ensamblado:: System.Runtime.dll

Ensamblado:: netstandard.dll

Ensamblado:: mscorlib.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural.

Sobrecargas

GetCultureInfo(String, Boolean)	Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural.
GetCultureInfo(String, String)	Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural. Los parámetros especifican una referencia cultural que se inicializa con los objetos TextInfo y CompareInfo especificados por otra referencia cultural.
GetCultureInfo(Int32)	Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural usando el identificador de referencia cultural especificado.
GetCultureInfo(String)	Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural utilizando el nombre de referencia cultural especificado.

GetCultureInfo(String, Boolean)

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural.

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

Parámetros

name: String

Nombre de una referencia cultural. No distingue mayúsculas de minúsculas.

predefinedOnly: Boolean

true si se solicita crear una instancia de una referencia cultural conocida por la plataforma. false si es correcto recuperar una referencia cultural inventada incluso si la plataforma no transporta datos para ella.

Devoluciones

CultureInfo

Instancia de solo lectura de una referencia cultural.

Comentarios

De forma predeterminada, al intentar crear cualquier referencia cultural y la plataforma subyacente (Windows NLS o ICU) no incluye datos específicos para esta referencia cultural, la plataforma intentará construir una referencia cultural con datos de otras referencia culturales o algunos valores constantes.

Establecer predefinedOnly en true garantizará que se cree una referencia cultural solo si la plataforma tiene datos reales para esa referencia cultural.

Se aplica a

GetCultureInfo(String, String)

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural. Los parámetros especifican una referencia cultural que se inicializa con los objetos TextInfo y CompareInfo especificados por otra referencia cultural.

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

Nombre de una referencia cultural. name no distingue entre mayúsculas y minúsculas.

altName: String

Nombre de una referencia cultural que proporciona los objetos TextInfo y CompareInfo utilizados para inicializar name. altName no distingue entre mayúsculas y minúsculas.

Devoluciones

CultureInfo

Un objeto CultureInfo de solo lectura.

Excepciones

ArgumentNullException

name o altName es null.

CultureNotFoundException

name o altName especifica una referencia cultural que no se admite. Vea la sección Notas para los llamadores para obtener más información.

Comentarios

Para obtener una lista de nombres de referencia cultural predefinidos en Windows, vea la columna Etiqueta de idioma en la lista de nombres de idioma o región admitidos por Windows. Los nombres de las referencias culturales siguen el estándar definido por BCP 47. Además, a partir de Windows 10, puede ser cualquier etiqueta de idioma name BCP-47 válida.

El GetCultureInfo método obtiene un objeto almacenado en caché y de solo CultureInfo lectura. Ofrece un mejor rendimiento que una llamada correspondiente a un CultureInfo constructor. El método se usa para crear una referencia cultural similar a la especificada por el parámetro , pero con reglas de ordenación y uso de name mayúsculas y minúsculas diferentes.

Si o es el nombre de la referencia cultural actual, los objetos devueltos name no reflejan ninguna altName invalidación de usuario. Si name es , el método devuelve la referencia cultural String.Empty invariable. Esto equivale a recuperar el valor de la InvariantCulture propiedad . Si es , el método usa el sistema de escritura y las reglas de comparación altName String.Empty especificadas por la referencia cultural invariable.

Notas a los autores de las llamadas

.NET Framework 3.5 y versiones anteriores inician si ArgumentException o no es un nombre de referencia cultural name altName válido. A partir .NET Framework 4, este método produce una CultureNotFoundException excepción . A partir de las aplicaciones que se ejecutan en .NET Framework 4 o posterior en Windows 7 o posterior, el método intenta recuperar un objeto cuyo identificador es del 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 CultureInfo una name name CultureNotFoundException excepción. A partir de las aplicaciones que se ejecutan en .NET Framework 4 o posterior en Windows 7 o posterior, el método intenta recuperar un objeto cuyo identificador es del 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 CultureInfo una name name CultureNotFoundException excepción.

En .NET 6 y versiones posteriores, se produce una excepción si la aplicación se ejecuta en un entorno donde está habilitado el modo de globalización invariable, por ejemplo, algunos contenedores de Docker y se especifica una referencia cultural distinta de la referencia cultural CultureNotFoundException invariable.

Consulte también

Se aplica a

GetCultureInfo(Int32)

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural usando el identificador de referencia cultural especificado.

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

Identificador de configuración regional (LCID).

Devoluciones

CultureInfo

Un objeto CultureInfo de solo lectura.

Excepciones

ArgumentOutOfRangeException

culture es menor que cero.

CultureNotFoundException

culture especifica una referencia cultural que no se admite. Para obtener más información, vea la sección Notas para los autores de llamada.

Comentarios

Se recomienda usar la sobrecarga de cadena de este método ( ), ya que se deben usar nombres de configuración regional GetCultureInfo(String) en lugar de LCID. Para las configuraciones regionales personalizadas, se requiere el nombre de la configuración regional.

Si culture es el identificador de configuración regional de la referencia cultural actual, el objeto CultureInfo devuelto no refleja ninguna invalidación de usuario.

Notas a los autores de las llamadas

.NET Framework 3.5 y versiones anteriores inician si ArgumentException no es un identificador de referencia cultural culture válido. A partir .NET Framework 4, este método produce una CultureNotFoundException excepción . A partir de las aplicaciones que se ejecutan en .NET Framework 4 o posterior en Windows 7 o versiones posteriores, el método intenta recuperar un objeto cuyo identificador es del sistema operativo; si el sistema operativo no admite esa referencia cultural, el método produce CultureInfo culture un CultureNotFoundException .

Consulte también

Se aplica a

GetCultureInfo(String)

Recupera una instancia almacenada en memoria caché, de solo lectura, de una referencia cultural utilizando el nombre de referencia cultural especificado.

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

Nombre de una referencia cultural. name no distingue entre mayúsculas y minúsculas.

Devoluciones

CultureInfo

Un objeto CultureInfo de solo lectura.

Excepciones

ArgumentNullException

name es null.

CultureNotFoundException

name especifica una referencia cultural que no se admite. Vea la sección Notas para los llamadores para obtener más información.

Comentarios

El GetCultureInfo método recupera un objeto almacenado en caché y de solo CultureInfo lectura. Ofrece un mejor rendimiento que una llamada correspondiente al CultureInfo.CultureInfo(String) constructor.

Si name es el nombre de la referencia cultural actual, el objeto devuelto no refleja ninguna CultureInfo invalidación de usuario. Esto hace que el método sea adecuado para las aplicaciones o herramientas de servidor que no tienen una cuenta de usuario real en el sistema y que necesitan cargar varias referencia culturales de forma eficaz.

Si name es , el método devuelve la referencia cultural String.Empty invariable. Esto equivale a recuperar el valor de la InvariantCulture propiedad .

Notas a los autores de las llamadas

.NET Framework 3.5 y versiones anteriores inician si ArgumentException no es un nombre de referencia cultural name válido. A partir .NET Framework 4, este método produce una CultureNotFoundException excepción . A partir de las aplicaciones que se ejecutan en .NET Framework 4 o posterior en Windows 7 o versiones posteriores, el método intenta recuperar un objeto cuyo identificador es del 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 CultureInfo name una name CultureNotFoundException excepción .

Consulte también

Name

Se aplica a