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, Boolean)
Inicializa una nueva instancia de la clase CultureInfo de acuerdo con la referencia cultural especificada mediante un nombre y con el valor booleano que indica si se va a utilizar la configuración de referencia cultural del sistema seleccionada por el usuario.
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.
- useUserOverride
- Tipo: System.Boolean
Valor booleano que indica si se utiliza la configuración de referencia cultural seleccionada por el usuario (true) o la configuración de referencia cultural predeterminada (false).
| 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 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.
Las aplicaciones normalmente no deberían permitir invalidaciones de usuario. Observe que no permitir reemplazos no garantiza la estabilidad de datos; vea la entrada del blog "Culture data shouldn't be considered stable (except for Invariant)" (http://blogs.msdn.com/shawnste/archive/2005/04/05/405694.aspx).
Si la propiedad UseUserOverride está establecida en true y el identificador de referencia cultural asociado al nombre de la referencia cultural especificada coincide con el identificador de la referencia cultural actual de Windows, este constructor crea un objeto CultureInfo que utiliza los nuevos valores, 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 devuelta 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.
En caso contrario, este constructor crea una CultureInfo que utiliza los valores predeterminados de la referencia cultural especificada.
El valor del parámetro useUserOverride pasa a ser el valor de la propiedad UseUserOverride.
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", true), Calendar se establece en GregorianCalendar (que es la configuración del usuario) y UseUserOverride se establece en true.
-
Con CultureInfo("ar-SA", false), Calendar se establece en HijriCalendar (que es el calendario predeterminado para ar-SA) y UseUserOverride se establece en false.
-
Con CultureInfo("th-TH", true), Calendar se establece en ThaiBuddhistCalendar (que es el calendario predeterminado para th-TH) y UseUserOverride se establece en true.
-
Con CultureInfo("th-TH", false), Calendar se establece en ThaiBuddhistCalendar (que es el calendario predeterminado para th-TH) y UseUserOverride se establece en false.
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 utilizar la configuración predeterminada de .NET Framework de moneda, la aplicación debe establecer el parámetro useUserOverride 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.
