System.Globalization.CultureAndRegionInfoBuilder construtor

Este artigo fornece observações complementares à documentação de referência para essa API.

Este artigo pertence ao CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) construtor.

O cultureName parâmetro especifica o nome do novo CultureAndRegionInfoBuilder objeto.

O flags parâmetro é usado para um CultureAndRegionModifiers valor que especifica se o novo CultureAndRegionInfoBuilder objeto é uma nova cultura personalizada ou substitui uma cultura neutra existente, cultura específica ou localidade do Windows.

Se o parâmetro especificar uma cultura .NET existente, cultura personalizada registrada ou cultura gerada a partir de uma localidade do Windows, o construtor preencherá automaticamente o cultureNameCultureAndRegionInfoBuilder novo CultureAndRegionInfoBuilder objeto com informações de cultura e país/região.

Preencha o novo CultureAndRegionInfoBuilder objeto com informações de cultura e país/região invocando os LoadDataFromCultureInfo métodos e LoadDataFromRegionInfo .

Nomes de cultura personalizados

O formato preferencial do cultureName parâmetro para uma nova cultura personalizada é "[-][-][-regionsuffix[prefix…]]language", onde o language componente é necessário e os prefixcomponentes , regione suffix são opcionais. O comprimento máximo de cada componente é de 8 caracteres e o comprimento máximo de todo cultureName o parâmetro é de 84 caracteres.

O prefix componente é a identificação da Internet Assigned Numbers Authority (IANA). Especifique "i-" ou "I-" para nomes de cultura registrados na IANA, ou "x-" ou "X-" para nomes de cultura reservados para uso privado. Caso contrário, o prefixo não será necessário. Para obter mais informações, consulte RFC 4646, "Tags para identificação de idiomas".

O language componente do parâmetro especifica um código de duas letras minúsculas cultureName derivado do ISO 639-1 e region especifica um código de duas letras maiúsculas derivado do ISO 3166. Por exemplo, en-US significa Inglês falado nos Estados Unidos. A ausência do region componente significa uma cultura neutra.

Um cultureName que é o mesmo que o nome de uma cultura incluída com o .NET significa uma cultura de substituição (substituição). Os valores que podem ser atribuídos às propriedades de uma cultura de substituição são limitados. Para obter mais informações sobre essas limitações, consulte as exceções para cada propriedade.

O aplicativo usa o suffix componente para distinguir culturas semelhantes. Por exemplo, duas empresas, ABC e XYZ, criam e compartilham um novo serviço Web ASP.NET para promover seus produtos em diferentes mercados ao redor do mundo. As páginas da Web do serviço exibem informações como o logotipo regional e o número de telefone local de cada empresa, dependendo da cultura do usuário. O conteúdo específico da cultura para cada página da Web está em arquivos de recursos separados identificados pelo nome da cultura e qualificados pelo nome da empresa. Por exemplo, os arquivos de recursos para as culturas en-US e ja-JP são denominados en-US-ABC, en-US-XYZ, ja-JP-ABC e ja-JP-XYZ. Os sufixos "ABC" e "XYZ" permitem que o serviço Web use a mesma lógica de aplicativo para exibir informações específicas de mercado diferentes.

O suffix componente pode consistir em subcomponentes, onde cada subcomponente é delimitado por um hífen e o comprimento máximo de cada subcomponente é de 8 caracteres. Por exemplo, se "en-US-honda-cars" é o parâmetro, "-honda-cars" é o cultureNamesuffix componente.