Constructor System.Globalization.CultureAndRegionInfoBuilder

En este artículo se proporcionan comentarios adicionales a la documentación de referencia de esta API.

Este artículo pertenece al CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) constructor .

El cultureName parámetro especifica el nombre del nuevo CultureAndRegionInfoBuilder objeto.

El flags parámetro se usa para un CultureAndRegionModifiers valor que especifica si el nuevo objeto es una nueva CultureAndRegionInfoBuilder referencia cultural personalizada o reemplaza una referencia cultural neutral existente, una referencia cultural específica o una configuración regional de Windows.

Si el cultureName parámetro especifica una referencia cultural de .NET existente, una referencia cultural personalizada registrada o una referencia cultural generada a partir de una configuración regional de Windows, el CultureAndRegionInfoBuilder constructor rellena automáticamente el nuevo CultureAndRegionInfoBuilder objeto con información de país o región y referencia cultural.

Rellene el nuevo CultureAndRegionInfoBuilder objeto con información de referencia cultural y país o región invocando los LoadDataFromCultureInfo métodos y LoadDataFromRegionInfo .

Nombres de referencia cultural personalizados

El formato preferido del cultureName parámetro para una nueva referencia cultural personalizada es "[prefix-][-region]language[-[-suffix[…]]", donde se requiere el language componente y los prefixcomponentes , regiony suffix son opcionales. La longitud máxima de cada componente es de 8 caracteres y la longitud máxima del parámetro completo cultureName es de 84 caracteres.

El prefix componente es la identificación de la autoridad de números asignados a Internet (IANA). Especifique "i-" o "I-" para los nombres de referencia cultural registrados con la IANA, o "x-" o "X-" para los nombres de referencia cultural reservados para uso privado. De lo contrario, el prefijo no es necesario. Para obtener más información, vea RFC 4646, "Etiquetas para la identificación de idiomas".

El language componente del cultureName parámetro especifica un código de dos letras minúsculas derivado de ISO 639-1 y region especifica un código de dos letras mayúsculas derivado de ISO 3166. Por ejemplo, en-US significa inglés como se habla en el Estados Unidos. La ausencia del region componente significa una referencia cultural neutra.

que cultureName es el mismo que el nombre de una referencia cultural incluida con .NET significa una referencia cultural de reemplazo (invalidación). Los valores que se pueden asignar a las propiedades de una referencia cultural de reemplazo son limitados. Para obtener más información sobre estas limitaciones, consulte las excepciones de cada propiedad.

La aplicación usa el suffix componente para distinguir referencias culturales similares. Por ejemplo, dos empresas, ABC y XYZ, crean y comparten un nuevo servicio web ASP.NET para promover sus productos en diferentes mercados de todo el mundo. Las páginas web del servicio muestran información como el logotipo regional y el número de teléfono local de cada empresa en función de la referencia cultural del usuario. El contenido específico de la referencia cultural para cada página web se encuentra en archivos de recursos independientes identificados por nombre de referencia cultural y calificados por nombre de empresa. Por ejemplo, los archivos de recursos para las referencias culturales en-US y ja-JP se denominan en-US-ABC, en-US-XYZ, ja-JP-ABC y ja-JP-XYZ. Los sufijos "ABC" y "XYZ" permiten al servicio web usar la misma lógica de aplicación para mostrar información específica del mercado diferente.

El suffix componente puede constar de subcomponentes, donde cada subcomponente está delimitado por un guión y la longitud máxima de cada subcomponente es de 8 caracteres. Por ejemplo, si "en-US-honda-cars" es el cultureName parámetro "-honda-cars" es el suffix componente .