CultureInfo.GetCultureInfo Método

  • Referencia

Definición

Espacio de nombres:
System.Globalization
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

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)

Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

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

Una instancia de solo lectura de una referencia cultural.

Comentarios

De forma predeterminada, al intentar crear cualquier referencia cultural y la plataforma subyacente (NLS o ICU de Windows) no lleva datos específicos para esta referencia cultural, la plataforma intentará construir una referencia cultural con datos de otras referencias 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)

Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

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 sistemas Windows, consulte 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, name puede ser cualquier etiqueta de idioma BCP-47 válida.

El GetCultureInfo método obtiene un objeto de solo lectura CultureInfo almacenado en caché. 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 name parámetro , pero con reglas de ordenación y mayúsculas y minúsculas diferentes.

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

Notas a los autores de las llamadas

.NET Framework 3.5 y versiones anteriores inician si ArgumentExceptionname o altName no es un nombre de referencia cultural válido. A partir de .NET Framework 4, este método produce una CultureNotFoundExceptionexcepció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 CultureInfo objeto cuyo identificador es name del sistema operativo; si el sistema operativo no admite esa referencia cultural y, si name no es el nombre de una referencia cultural complementaria o de reemplazo, el método produce una CultureNotFoundException excepción.

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

Consulte también

Se aplica a

GetCultureInfo(Int32)

Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

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 (GetCultureInfo(String)), ya que se deben usar nombres de configuración regional en lugar de LCID. En el caso de 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 devuelto CultureInfo no refleja las invalidaciones del usuario.

Notas a los autores de las llamadas

.NET Framework 3.5 y versiones anteriores inician si ArgumentExceptionculture no es un identificador de referencia cultural válido. A partir de .NET Framework 4, este método produce una CultureNotFoundExceptionexcepció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 CultureInfo objeto cuyo identificador es culture del sistema operativo; si el sistema operativo no admite esa referencia cultural, el método inicia una CultureNotFoundExceptionexcepción .

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

Consulte también

Se aplica a

GetCultureInfo(String)

Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

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

Para obtener una lista de nombres de referencia cultural predefinidos en sistemas Windows, consulte 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, name puede ser cualquier etiqueta de idioma BCP-47 válida.

El GetCultureInfo método recupera un objeto almacenado en caché y de solo lectura CultureInfo . 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 CultureInfo no refleja ninguna 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 referencias culturales de forma eficaz.

Si name es String.Empty, el método devuelve la referencia cultural 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 ArgumentExceptionname no es un nombre de referencia cultural válido. A partir de .NET Framework 4, este método produce una CultureNotFoundExceptionexcepció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 CultureInfo objeto cuyo identificador es name del sistema operativo; si el sistema operativo no admite esa referencia cultural y, si name no es el nombre de una referencia cultural complementaria o de reemplazo, el método produce una CultureNotFoundExceptionexcepción .

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

Consulte también

Se aplica a