CultureInfo (Clase)

La clase CultureInfo especifica un nombre único para cada referencia cultural, basándose en RFC 4646 (Windows Vista y posterior). Este nombre está formado por un código ISO 639 para la referencia cultural que está asociado a un idioma y se compone de dos letras minúsculas y por un código ISO 3166 para la referencia cultural secundaria que está asociado a un país o región y está compuesto de dos letras.

El formato del nombre de la referencia cultural es "<códigoIdioma2>-<códigoPaís/Región2>", donde <códigoIdioma2> es el código del idioma y <códigoPaís/Región2> es el código de la referencia cultural secundaria. Algunos ejemplos son ja-JP para japonés (Japón) y en-US para inglés (Estados Unidos). En los casos en que no hay disponible un código de idioma de dos letras, se utiliza un código de tres letras basado en el estándar ISO 639-2.

Conviene tener en cuenta que algunos nombres de referencia cultural también especifican un alfabeto de ISO 15924. Por ejemplo, "- Cyrl" especifica el alfabeto para cirílico y "- Latn" especifica el alfabeto para latín. En Windows Vista y posterior, un nombre de referencia cultural que contiene un alfabeto se puede representar utilizando el modelo <códigoIdioma2>-<etiquetaDeAlfabeto>-<códigoPaís/Región2>. Un ejemplo de este tipo de nombre de referencia cultural es uz-Cyrl-UZ para uzbeco (cirílico, Uzbekistán). En los sistemas operativos anteriores a Windows Vista, un nombre de referencia cultural que contenga un alfabeto se procesa utilizando el modelo <códigoIdioma2>-<códigoPaís/Región2>-<etiquetaDeAlfabeto>, por ejemplo, uz-UZ-Cyrl para uzbeco (cirílico, Uzbekistán).

Una referencia cultural neutra se especifica únicamente mediante un código de idioma formado por dos letras minúsculas. Por ejemplo, "fr" especifica la referencia cultural neutra para francés y "de" especifica la referencia cultural neutra para alemán.

Nota
Hay dos referencias culturales que contradicen esta regla. Las referencias culturales "zh-Hans" (chino simplificado) y "zh-Hant" (chino tradicional) son referencias culturales neutras. Los nombres de la referencia cultural representan el estándar actual y se deben usar a menos que tenga una razón para utilizar los nombres anteriores "zh-CHS" y "zh-CHT".

Un identificador de referencia cultural es una abreviatura numérica internacional estándar y tiene los componentes necesarios para identificar una de las referencias culturales instaladas singularmente. La aplicación puede utilizar identificadores de referencia cultural predefinidos o definir identificadores personalizados.

Esta y otras clases en el espacio de nombres System.Globalization utilizan determinados nombres e identificadores de las referencias culturales predefinidas. Información detallada sobre la referencia cultural aparece en National Language Support (NLS) API Reference en el Centro de desarrolladores Go Global.

Recuerde que los nombres de la referencia cultural e identificadores representan sólo un subconjunto de referencias culturales que se pueden buscar en un equipo determinado. Las versiones o los service pack de Windows pueden cambiar las referencias culturales disponibles. Las aplicaciones agregan referencias culturales personalizadas mediante la clase CultureAndRegionInfoBuilder. Los usuarios agregan sus propias referencias culturales personalizadas mediante la herramienta Microsoft Locale Builder. Microsoft Locale Builder está escrito en código administrado mediante la clase CultureAndRegionInfoBuilder.

Algunos nombres están estrechamente asociados a una referencia cultural, en particular los nombres asociados con los miembros de clase siguientes:

• CultureInfo.ToString

• CultureInfo.Name

• CompareInfo.Name

Vea Nombres asociados a un objeto CultureInfo para obtener más información sobre la relación que existe entre estos nombres.

Las referencias culturales se han dividido en tres grupos: referencias culturales de todos los idiomas, referencias culturales neutras y referencias culturales específicas.

La referencia cultural de todos los idiomas no tiene en cuenta la referencia cultural. La aplicación especifica la referencia cultural de todos los idiomas por nombre mediante una cadena vacía ("") o por su identificador. InvariantCulture define una instancia de la referencia cultural de todos los idiomas. Se encuentra asociada al idioma inglés pero a ningún país o región. Se puede utilizar en casi todos los métodos del espacio de nombres de Globalization que requieran una referencia cultural.

Una referencia cultural neutra es aquélla asociada a un idioma pero no a un país o región. Una referencia cultural específica es la que está asociada a un idioma y a un país o región. Por ejemplo, fr es la referencia cultural neutra para francés y fr-FR es el nombre del francés especifico. Tenga en cuenta que chino (simplificado) y chino (tradicional) son referencias culturales neutras.

No se recomienda la creación de instancias de una clase CompareInfo para una referencia cultural neutra porque los datos que contiene son arbitrarios. Para mostrar y ordenar los datos, especifique el lenguaje y región. Además, la propiedad Name de un objeto CompareInfo creada para una referencia cultural neutra devuelve sólo el país y no incluye la región.

Las referencias culturales definidas tienen una jerarquía en que la referencia principal de una referencia cultural específica es una referencia cultural neutra, y la referencia cultural principal de una neutra es la referencia cultural de todos los idiomas. La propiedad Parent contiene la referencia cultural neutra asociada a una referencia cultural específica. Las referencias culturales personalizadas deben establecer la propiedad Parent con arreglo a este modelo.

Si los recursos de una referencia cultural concreta no están disponibles en el sistema operativo, se usan los recursos de la referencia cultural neutra asociada. Si los recursos de la referencia cultural neutra no están disponibles, se usan los recursos incrustados en el ensamblado principal. Para obtener más información sobre el proceso de reserva de recursos, vea Empaquetar e implementar recursos.

La lista de referencias culturales de la API de Windows es ligeramente diferente de la lista de referencias culturales que admite .NET Framework. Si es necesaria la interoperabilidad con Windows (por ejemplo, mediante el mecanismo p/invoke), la aplicación debe usar una referencia cultural específica definida en el sistema operativo. El uso de referencias culturales específicas garantiza la coherencia con la configuración regional de Windows equivalente, que se establece mediante un identificador de configuración regional que es el mismo que el de la propiedad LCID.

DateTimeFormatInfo o NumberFormatInfo sólo se pueden crear para la referencia cultural invariable o para referencias culturales específicas, pero no para referencias culturales neutras.

Si DateTimeFormatInfo.Calendar es el objeto TaiwanCalendar pero Thread.CurrentCulture no se establece en "zh-TW", entonces DateTimeFormatInfo.NativeCalendarName, DateTimeFormatInfo.GetEraName y DateTimeFormatInfo.GetAbbreviatedEraName devuelven una cadena vacía ("").

Al preparar el software para administrar las referencias culturales personalizadas, considere lo siguiente:

• Las referencias culturales personalizadas pueden tener valores que superen los intervalos de las referencias culturales distribuidas por Microsoft. Por ejemplo, algunas referencias culturales tienen nombres de mes largos, formatos de fecha o de hora inesperados u otros datos no habituales.

• Respete los valores de datos de la referencia cultural del usuario; por ejemplo, el usuario quizá desee un reloj de 24 horas o un formato de fecha aaaaMMdd.

• Recuerde que las referencias culturales personalizadas invalidan los valores predeterminados. Por consiguiente, no puede considerar que los datos de las referencias culturales sean estables. Los nombres de países, los formatos de fecha, la ortografía, etc. es probable que cambien en el futuro. Si la aplicación necesita serializar el uso de estos datos, como ocurre con el formato y las funciones de análisis de DateTime, se debe utilizar la referencia cultural de todos los idiomas o un formato concreto.

Excepto en la referencia cultural de todos los idiomas, los datos de la referencia cultural son dinámicos. Esto es así incluso en las referencias culturales predefinidas. Por ejemplo, los países o regiones adoptan nuevas monedas, cambian la ortografía de sus palabras o modifican su modelos de calendario preferidos y las definiciones de las referencias culturales varían para dar cuenta de ello. Las referencias culturales personalizadas pueden cambiar sin previo aviso y cualquier referencia cultural específica podría reemplazarse por una referencia cultural personalizada. Además, tal y como veremos después, un usuario individual podría reemplazar las preferencias culturales. Las aplicaciones siempre deben obtener los datos de la referencia cultural en tiempo de ejecución.

Precaución

Al guardar los datos, la aplicación debe usar la referencia cultural de todos los idiomas, con el formato binario o el formato independiente de una referencia cultural específica. Los datos que se guardan conforme a los valores actuales asociados a una referencia cultural determinada, que no sea la referencia cultural de todos los idiomas, podrían ser ilegibles o variar su significado si cambia esa referencia cultural.

Cuando se serializa un objeto CultureInfo, lo que realmente se guarda es Name y UseUserOverride. La serialización sólo se puede anular correctamente en un entorno en el que Name tenga el mismo significado. En los tres ejemplos siguientes se muestra por qué no siempre ocurre esto.

• Si CultureTypes indica CultureTypes.WindowsOnlyCultures y esa referencia cultural se especifica primero en Windows Vista, no es posible anular su serialización en Windows XP. De igual forma, si la referencia cultural se incluyó primero en Windows XP Service Pack 2, no es posible anular su serialización en un sistema Windows XP en el que no se haya instalado la referencia cultural.

• Si CultureTypes indica CultureTypes.UserCustomCulture y el equipo en el que debe deserializarse no tiene instalada esta referencia cultural personalizada, no es posible realizar la operación.

• Si CultureTypes indica CultureTypes.ReplacementCultures y el equipo en el que debe deserializarse no tiene esta referencia cultural de reemplazo, se deserializa en el mismo nombre, pero no las mismas características. Por ejemplo, si “en-US” es una referencia cultural de reemplazo en el equipo A, pero no en el equipo B, y un objeto CultureInfo asociado a esta referencia cultural se serializa en el equipo A y se deserializa en el equipo B, no se transmite ninguna de las características personalizadas de esta referencia cultural. La referencia cultural se deserializará correctamente, pero con un significado distinto.

A partir de la versión 2.0 de .NET Framework, el constructor CultureInfo admite el uso de configuraciones regionales de Windows, que son equivalentes a las referencias culturales, para generar automáticamente referencias culturales que no existan en .NET Framework. Para obtener más información, vea Referencias culturales creadas a partir de configuraciones regionales de Windows.

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. En general, las aplicaciones deben respetar estas invalidaciones del usuario.

Si UseUserOverride es true y la referencia cultural especificada coincide con la referencia cultural actual de Windows, CultureInfo utiliza estos 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 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.

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.

La referencia cultural "Español (España)" utiliza dos identificadores de referencia cultural, 0x0C0A (que utiliza el criterio de ordenación internacional predeterminado) y 0x040A (que utiliza el criterio de ordenación tradicional). Si la clase CultureInfo se construye utilizando el nombre de referencia cultural es-ES, la nueva CultureInfo utiliza el criterio de ordenación internacional predeterminado. En el criterio de ordenación tradicional, el objeto se construye utilizando el nombre es-ES_tradnl. Para obtener información sobre otras referencias culturales con ordenaciones alternativas, vea Comparar y ordenar datos para una referencia cultural específica.

Esta clase implementa la interfaz ICloneable para habilitar la duplicación de objetos CultureInfo. También implementa IFormatProvider para proporcionar información de formato a aplicaciones.

Hay consideraciones únicas que deben tenerse en cuenta al utilizar un subproceso asociado a un objeto CultureInfo. Para obtener más información sobre las referencias culturales y dominios de aplicación, vea Dominios de aplicación y subprocesos.