Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
CultureInfo (Constructor) (String)
Inicializa una nueva instancia de la clase CultureInfo de acuerdo con la referencia cultural especificada mediante un nombre.
Ensamblado: mscorlib (en mscorlib.dll)
Parámetros
- name
- Tipo: System.String
Nombre de CultureInfo predefinido, Name de una clase CultureInfo existente, o nombre de referencia cultural sólo de Windows.
| Excepción | Condición |
|---|---|
| ArgumentNullException |
name es null. |
| CultureNotFoundException |
name no es un nombre de referencia cultural válido. |
Si name es String.Empty, el constructor crea una instancia de la referencia cultural de todos los idiomas; esto es equivalente a recuperar el valor de la propiedad InvariantCulture.
El usuario puede optar por invalidar algunos de los valores asociados a la referencia cultural actual de Windows a través de de la configuración referente a las opciones de configuración regional y de idioma del Panel de control. Por ejemplo, el usuario puede mostrar la fecha en un formato diferente o utilizar una moneda diferente a la predeterminada para la referencia cultural. Si el identificador de referencia cultural asociado a name coincide con el identificador de la referencia cultural actual de Windows, este constructor crea un objeto CultureInfo que utiliza esas invalidaciones, incluida la configuración del usuario para las propiedades de la instancia de DateTimeFormatInfo devuelta por la propiedad DateTimeFormat, y las propiedades de la instancia de NumberFormatInfo devueltas por la propiedad NumberFormat. Si la configuración del usuario no es compatible con la referencia cultural asociada a CultureInfo (por ejemplo, si el calendario seleccionado no es uno de OptionalCalendars), no se definen los resultados de los métodos y los valores de las propiedades.
Si el identificador de referencia cultural asociado a name no coincide con el identificador de la referencia cultural actual de Windows, este constructor crea un objeto CultureInfo que utiliza los valores predeterminados de la referencia cultural especificada.
La propiedad UseUserOverride siempre se establece en true.
Por ejemplo, suponga que la referencia cultural actual de Windows es "Árabe (Arabia Saudí)" y que el usuario ha cambiado el calendario de Hijri a Gregoriano.
-
Con CultureInfo("ar-SA"), Calendar se establece en GregorianCalendar (que es la configuración del usuario) y UseUserOverride se establece en true.
-
Con CultureInfo("th-TH"), Calendar se establece en ThaiBuddhistCalendar (que es el calendario predeterminado para th-TH) y UseUserOverride se establece en true.
La propiedad LCID del nuevo CultureInfo se establece en el identificador de referencia cultural asociado al nombre especificado.
En las referencias culturales que utilizan el euro, .NET Framework y Windows XP establecen el euro como moneda predeterminada. Esto no ocurre, sin embargo, en las versiones anteriores de Windows. Por consiguiente, si el usuario de una versión antigua de Windows no ha cambiado la moneda a través de la configuración referente a las opciones de configuración regional y de idioma del Panel de control, la moneda podría ser incorrecta. Para usar la configuración predeterminada de .NET Framework para la moneda, debe usar en la aplicación una sobrecarga del constructor CultureInfo que acepte un parámetro useUserOverride y establecerlo en false.
Notas para los llamadores
.NET Framework versión 3.5 y las versiones anteriores producen una ArgumentException si name no es un nombre de referencia cultural válido. A partir de .NET Framework versión 4, este constructor produce una CultureNotFoundException.
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
