Classe CultureInfo

O CultureInfo classe especifica um nome exclusivo para cada cultura, com base no RFC 4646 (Windows Vista e posterior). O nome é uma combinação de um código de cultura de duas letras minúsculas ISO 639 associado com um idioma e um código de subcultura de duas letras maiúsculas ISO 3166 associado a um país ou região.

O formato para o nome de cultura é "<languagecode2>-< país/regioncode2 >", onde <languagecode2> é o código de idioma e < país/regioncode2 > é o código de subcultura. Exemplos incluem ja-JP para japonês (Japão) e en-US para inglês (Estados Unidos). Em casos onde um código de idioma com duas letras não está disponível, um código de três letras derivado ISO 639-2 é usado.

Observe que alguns nomes de cultura também especificar um script ISO 15924. Por exemplo, "-Cyrl" Especifica o script cirílico e "-Latn" Especifica o script latino. No Windows Vista e posterior, um nome de cultura, incluindo um script é processado usando o padrão de <languagecode2> - <scripttag> - < país/regioncode2 >. Um exemplo desse tipo de nome de cultura é uz-Cyrl-UZ para Uzbek (cirílico, Uzbequistão). Sistemas de operacionais anteriores ao Windows Vista, um nome de cultura, incluindo um script é processado usando o padrão de <languagecode2> - < país/regioncode2 > - <scripttag>, por exemplo, uz-UZ-Cyrl para Uzbek (cirílico, Uzbequistão).

Uma cultura neutra é especificada pelo somente o código do idioma de duas letras minúsculas. Por exemplo, "fr" Especifica a cultura neutra para francês e "de" Especifica a cultura neutra para alemão.

Observação
Há dois nomes de cultura que contradigam esta regra. As culturas chamado zh-Hans em chinês (simplificado) e chinês (tradicional), denominado zh-Hant, são culturas neutras. Os nomes de cultura representam o padrão atual e devem ser usados a menos que você tenha um motivo para usar os nomes antigos "zh-CHS" e "zh-CHT".

Um identificador de cultura é uma abreviatura numérica internacional padrão e tem os componentes necessários para identificar exclusivamente uma das culturas instaladas. Seu aplicativo pode usar identificadores de cultura predefinidos ou definir identificadores personalizados.

Certos predefinidas de nomes de cultura e os identificadores são usados por essa e outras classes de System.Globalization namespace. Informações de cultura detalhadas aparecem no Referência da API de suporte de idiomas nacionais (NLS) em que o Go Global Developer Center.

Lembre-se de que os nomes de cultura e os identificadores representam apenas um subconjunto de culturas que podem ser encontrados em um computador específico. Versões do Windows ou service packs podem alterar as culturas disponíveis. Aplicativos adicionam culturas personalizadas usando o CultureAndRegionInfoBuilder classe. Os usuários adicionar seus próprios culturas personalizadas usando a ferramenta Microsoft Locale Builder. Microsoft Locale Builder é escrito em código gerenciado usando o CultureAndRegionInfoBuilder classe.

Vários nomes distintos estão intimamente associados uma cultura, notadamente os nomes associados com os seguintes membros de classe:

• CultureInfo.ToString

• CultureInfo.Name

• CompareInfo.Name

Consulte Nomes associados a um objeto CultureInfo para uma discussão sobre a relação entre esses nomes.

As culturas são geralmente agrupadas em três conjuntos: culturas invariável, culturas neutras e culturas específicas.

Uma cultura invariável é insensível à cultura. O aplicativo especifica a cultura invariável pelo nome usando uma seqüência vazia ("") ou por seu identificador. InvariantCulture define uma instância da cultura invariável. Ele está associado com o idioma inglês, mas não com qualquer país/região. Ele é usado em quase qualquer método no Globalization namespace que requer uma cultura.

Uma cultura neutra é uma cultura que está associada com um idioma, mas não com um país/região. Uma cultura específica é uma cultura que está associada com um idioma e país/região. Por exemplo, o fr é o nome de neutro para a cultura francesa e fr-FR é o nome da cultura específica do francês (França). Observe que o chinês (simplificado) e chinês (tradicional) também são considerados culturas neutras.

Criando uma instância de um CompareInfo para uma cultura neutra não é recomendada porque os dados que ele contém serão arbitrários de classe. Para exibir e classificar dados, especifique o idioma e a região. Além disso, o Name propriedade de um CompareInfo objeto criado para uma cultura neutra retorna somente o país e não inclui a região.

As culturas definidas tem uma hierarquia na qual o pai de uma cultura específica é uma cultura neutra e o pai de uma cultura neutra é a cultura invariável. O Parent propriedade contém a cultura neutra, associada a uma cultura específica. Culturas personalizadas devem definir o Parent propriedade em conformidade com o padrão.

Se os recursos para uma cultura específica não estiverem disponíveis no sistema operacional, os recursos para a cultura neutra associado são usados. Se os recursos para a cultura neutra não estiverem disponíveis, os recursos incorporados no assembly principal são usados. Para obter mais informações sobre o processo de fallback de recurso, consulte Empacotamento e implantação de recursos.

A lista de localidades da API do Windows é um pouco diferente da lista de culturas suportados pelo.NET Framework. Se a interoperabilidade com o Windows for necessária, por exemplo, através do mecanismo p/invoke, o aplicativo deve usar uma cultura específica que está definida para o sistema operacional. O uso da cultura específica garante a consistência com a localidade do Windows equivalente, que é identificada com um identificador de localidade é o mesmo que LCID.

Um DateTimeFormatInfo ou NumberFormatInfo podem ser criados somente para a cultura invariável ou de culturas específicas, não para culturas neutras.

Se DateTimeFormatInfo.Calendar é o TaiwanCalendar , mas o Thread.CurrentCulture não está definido como "zh-TW", em seguida, DateTimeFormatInfo.NativeCalendarName, DateTimeFormatInfo.GetEraName, e DateTimeFormatInfo.GetAbbreviatedEraName retornar uma seqüência vazia ("").

Ao preparar o software para lidar com culturas personalizadas, considere o seguinte:

• Culturas personalizadas podem ter valores que excedem os intervalos das culturas fornecido a Microsoft. Por exemplo, algumas culturas têm nomes de meses anormalmente longo, data inesperada ou formatos de hora ou outros dados incomuns.

• Respeitar os valores de dados de cultura do usuário; Por exemplo, o usuário poderá um relógio de 24 horas ou em um formato de data aaaammdd.

• Lembre-se de culturas personalizadas substituam os valores padrão. Portanto, você não pode considerar os dados de cultura a ser estável. Nomes de países, formatos de data, erros de ortografia, etc., provavelmente será alterado no futuro. Se seu aplicativo precisar serializar usando esses dados, como para o DateTime formatação e análise de funções, ele deve usar a cultura invariável ou em um formato específico.

Exceto para a cultura invariável, dados de cultura são dinâmicos. Isso é verdadeiro mesmo para as culturas predefinidas. Por exemplo, países ou regiões adotam novas moedas, alterar seus erros de ortografia de palavras ou alterar seu calendário preferencial e definições de cultura alterar para controlar isso. Culturas personalizadas estão sujeitos a alterações sem aviso prévio e qualquer cultura específica pode ser substituída por uma cultura personalizada substituta. Além disso, conforme discutido abaixo, um usuário individual pode substituir as preferências culturais. Aplicativos sempre devem obter dados de cultura em tempo de execução.

Cuidado
Ao salvar os dados, seu aplicativo deve usar a cultura invariável, use um formato binário ou usar um formato específico de cultura independente. Dados a salvo de acordo com os valores atuais associados a uma determinada cultura diferente, por exemplo, a cultura invariável, podem se tornar ilegíveis ou podem ser alteradas em significado, se essa cultura for alterado.

Quando um CultureInfo objeto é serializado, tudo o que realmente está armazenado é Name e UseUserOverride. É de-serialized com êxito somente em um ambiente onde que Name tem o mesmo significado. Os três exemplos a seguir mostram por que isso não é sempre o caso:

• Se CultureTypes indica CultureTypes.WindowsOnlyCultures, e se essa cultura foi introduzida no Windows Vista, não é possível desserializar a ele no Windows XP. Da mesma forma, se a cultura foi introduzida no Windows XP Service Pack 2, não é possível desserializá-lo para um sistema Windows XP no qual a cultura não foi instalada.

• Se CultureTypes indica CultureTypes.UserCustomCulturee o computador no qual está de-serialized não tem essa cultura personalizada de usuário instalada, não é possível desserializar o proprietário.

• Se CultureTypes indica CultureTypes.ReplacementCulturese o computador no qual está de-serialized não tem essa cultura substituta, ele desfaz a serialização do mesmo nome, mas nem todas as mesmas características. Por exemplo, se "en-US" é uma cultura de substituição no computador A, mas não no computador b e se um CultureInfo objeto referindo-se a essa cultura é serializado no computador a e ser desserializado no computador B, em seguida, nenhuma das características da cultura personalizadas são transmitidas. A cultura desfaz a serialização do êxito, mas com um significado diferente.

A partir do.NET Framework versão 2.0, o CultureInfo construtor dá suporte ao uso de localidades do Windows, são equivalentes às culturas, para automaticamente gerar culturas que não existem na.NET Framework. For more information, see Culturas geradas a partir de localidades do Windows.

O usuário pode optar por substituir alguns dos valores associados a cultura atual do Windows por meio da parte de opções regionais e de idioma do painel de controle. Por exemplo, o usuário pode escolher para exibir a data em um formato diferente ou para usar uma moeda diferente da padrão para a cultura. Em geral, os aplicativos devem honrar essas substituições do usuário.

Se UseUserOverride é true e a cultura especificada corresponde a cultura atual do Windows, o CultureInfo usa essas substituições, incluindo configurações de usuário para as propriedades da DateTimeFormatInfo instância retornada pelo DateTimeFormat propriedade e as propriedades da NumberFormatInfo instância retornada pelo NumberFormat propriedade. Se as configurações de usuário são incompatíveis com a cultura associada a CultureInfo, por exemplo, se o calendário selecionado não é um da OptionalCalendars, os resultados dos métodos e os valores das propriedades são indefinidos.

Para culturas que usam o euro.NET Framework e o Windows XP definem a moeda padrão como euro. No entanto, as versões mais antigas do Windows não. Portanto, se o usuário de uma versão antiga do Windows não mudou a configuração de moeda por meio de parte de opções regionais e de idioma do painel de controle, a moeda esteja incorreta. Para usar o.NET Framework configuração padrão para a moeda, o aplicativo deve usar um CultureInfo sobrecarga do construtor que aceita um useUserOverride parâmetro e defini-la false.

A cultura Espanhol (Espanha) usa dois identificadores de cultura, 0x0C0A usando a ordem de classificação internacional padrão e 0x040A usando a ordem de classificação tradicional. Se a CultureInfo é construída usando o nome de cultura de es-ES, o novo CultureInfo usa a ordem de classificação internacional padrão. Para a ordem de classificação tradicional, o objeto é construído usando o nome es-ES_tradnl. Para obter informações sobre outras culturas que têm classificações alternativas, consulte Comparar e classificar dados para uma cultura específica.

Essa classe implementa o ICloneable interface para ativar a duplicação de CultureInfo objetos. Ele também implementa IFormatProvider para fornecer informações de formatação para os aplicativos.

Há considerações exclusivas ao usar um segmento associado com um CultureInfo objeto. Para obter mais informações sobre culturas e domínios de aplicativo, consulte Domínios de Aplicativos e Segmentos.