CultureAndRegionInfoBuilder Classe

Definição

public ref class CultureAndRegionInfoBuilder sealed

[System.Runtime.InteropServices.ComVisible(false)]
public sealed class CultureAndRegionInfoBuilder

[<System.Runtime.InteropServices.ComVisible(false)>]
type CultureAndRegionInfoBuilder = class

Public NotInheritable Class CultureAndRegionInfoBuilder

Herança

Object

CultureAndRegionInfoBuilder

Atributos

ComVisibleAttribute

Observações

A CultureInfo classe contém informações específicas da cultura, como o idioma associado, subidioma, país/região, calendário e convenções culturais. Essa classe também fornece instâncias específicas de cultura das classes DateTimeFormatInfo, NumberFormatInfo, CompareInfo e TextInfo, que são necessárias para operações específicas da cultura, como manipulação de maiúsculas e minúsculas, formatação e análise de datas e números, e comparação de cadeias de caracteres.

Por defeito, o .NET Framework suporta CultureInfo objetos que representam um conjunto pré-definido de culturas. Para obter uma lista dessas culturas disponíveis em sistemas Windows, consulte a coluna Marca de idioma na lista de nomes de idioma/região suportados pelo Windows. Os nomes das culturas seguem o padrão definido pelo BCP 47. A CultureAndRegionInfoBuilder classe permite que você crie uma cultura personalizada que é completamente nova ou que substitui uma cultura predefinida. Quando uma cultura personalizada é instalada e registrada em um determinado computador, ela se torna indistinguível de objetos predefinidos CultureInfo e pode ser instanciada e usada exatamente como esses objetos.

Uma cultura personalizada só pode ser registada num computador por um utilizador que tenha direitos administrativos nesse computador. Consequentemente, os aplicativos normalmente não criam e instalam culturas personalizadas. Em vez disso, você pode usar a CultureAndRegionInfoBuilder classe para criar uma ferramenta de finalidade especial que um administrador pode usar para criar, instalar e registrar uma cultura personalizada. Depois que a cultura personalizada for registrada em um computador, você poderá usar a CultureInfo classe em seu aplicativo para criar instâncias da cultura personalizada da mesma forma que faria para uma cultura predefinida.

Se analisar cadeias de caracteres de data e hora geradas para uma cultura personalizada, deverá usar o método DateTime.ParseExact ou DateTime.TryParseExact em vez do método DateTime.Parse ou DateTime.TryParse para melhorar a probabilidade de êxito da operação de análise. Uma cadeia de caracteres de data e hora para uma cultura personalizada pode ser complicada e, portanto, difícil de analisar. Os Parse métodos e TryParse tentam analisar uma cadeia de caracteres com vários padrões de análise implícitos, todos os quais podem falhar. O TryParseExact método, por outro lado, requer que o aplicativo designe explicitamente um ou mais padrões de análise exatos que provavelmente terão êxito.

Definindo e Criando uma Cultura Personalizada

Você usa a CultureAndRegionInfoBuilder classe para definir e nomear uma cultura personalizada. A cultura personalizada pode ser uma cultura totalmente nova, uma nova cultura baseada numa cultura existente (ou seja, uma cultura suplementar), ou uma cultura que substitui uma cultura existente do .NET Framework. Em cada caso, os passos básicos são os mesmos:

1. Instancie um CultureAndRegionInfoBuilder objeto chamando seu CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) construtor. Para substituir uma cultura existente, passe o nome da cultura e o valor de enumeração CultureAndRegionModifiers.Replacement para o construtor. Para criar uma nova cultura ou uma cultura suplementar, passe um exclusivo nome de cultura e o valor de enumeração CultureAndRegionModifiers.Neutral ou CultureAndRegionModifiers.None.

   Note

   Se você usar o CultureAndRegionModifiers.Replacement valor de enumeração para instanciar um CultureAndRegionInfoBuilder objeto, as propriedades do objeto serão preenchidas CultureAndRegionInfoBuilder automaticamente com valores do CultureInfo objeto a ser substituído.

2. Se você estiver criando uma cultura nova ou suplementar:

   • Preencha as propriedades do objeto CultureAndRegionInfoBuilder chamando o método LoadDataFromCultureInfo e passando um objeto CultureInfo cujos valores de propriedade são semelhantes ao seu novo objeto.

   • Preencha as propriedades regionais do objeto CultureAndRegionInfoBuilder chamando o método LoadDataFromRegionInfo e passando um objeto RegionInfo que representa a região da sua cultura personalizada.

3. Modifique as CultureAndRegionInfoBuilder propriedades do objeto conforme necessário.

4. Caso esteja a planear registar a cultura personalizada numa rotina separada, chame o método Save. Isso gera um arquivo XML que você pode carregar e registrar em uma rotina de instalação de cultura personalizada separada.

Registo de uma Cultura Personalizada

Se você estiver desenvolvendo um aplicativo de registro para uma cultura personalizada separada do aplicativo que cria a cultura, chamará o CreateFromLdml método para carregar o arquivo XML que contém a definição da cultura personalizada e instanciar o CultureAndRegionInfoBuilder objeto. Para lidar com o registro, chame o Register método. Para que o registro seja bem-sucedido, o aplicativo que registra a cultura personalizada deve estar sendo executado com privilégios administrativos no sistema de destino; caso contrário, a chamada para Register lança uma UnauthorizedAccessException exceção.

O processo de registo executa as seguintes tarefas:

• Cria um ficheiro .nlp que contém a informação definida no CultureAndRegionInfoBuilder objeto.

• Armazena o ficheiro .nlp no diretório %windir%\Globalization system no computador alvo. Isso permite que as configurações da cultura personalizada persistam entre as sessões. (O CultureAndRegionInfoBuilder método requer privilégios administrativos porque o ficheiro .nlp é armazenado num diretório do sistema.)

• Prepara .NET Framework para pesquisar o diretório do sistema %windir%\Globalization em vez de uma cache interna da próxima vez que houver um pedido para criar a sua nova cultura personalizada.

Quando uma cultura personalizada é registada com sucesso, é indistinguível das culturas que são pré-definidas pelo .NET Framework. A cultura personalizada está disponível até que uma chamada ao CultureAndRegionInfoBuilder método remova o ficheiro .nlp do computador local.

Instauração de uma Cultura Personalizada

Você pode criar uma instância da cultura personalizada de uma das seguintes maneiras:

• Ao invocar o CultureInfo.CultureInfo construtor com o nome da cultura.
• Chamando o CultureInfo.CreateSpecificCulture método com o nome da cultura.
• Chamando o CultureInfo.GetCultureInfo método com o nome da cultura.

Além disso, a matriz de CultureInfo objetos que é retornada pelo método CultureInfo.GetCultures inclui a cultura personalizada.

Example

O exemplo seguinte define uma cultura ru-US costume que representa a língua russa no Estados Unidos. O exemplo define a cultura personalizada ao carregar definições do objeto russo (Rússia) CultureInfo e do objeto dos EUA RegionInfo , e depois define várias CultureAndRegionInfoBuilder propriedades. O exemplo regista a cultura personalizada, depois instancia-a e transforma-a na cultura atual.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      // Create a custom culture for ru-US.
      CultureAndRegionInfoBuilder car1 = new CultureAndRegionInfoBuilder("ru-US",
                                             CultureAndRegionModifiers.None);
      car1.LoadDataFromCultureInfo(CultureInfo.CreateSpecificCulture("ru-RU"));
      car1.LoadDataFromRegionInfo(new RegionInfo("en-US"));

      car1.CultureEnglishName = "Russian (United States)";
      car1.CultureNativeName = "русский (США)";
      car1.CurrencyNativeName = "Доллар (США)";
      car1.RegionNativeName = "США";

      // Register the culture.
      try {
         car1.Register();
      }
      catch (InvalidOperationException) {
         // Swallow the exception: the culture already is registered.
      }

      // Use the custom culture.
      CultureInfo ci = CultureInfo.CreateSpecificCulture("ru-US");
      Thread.CurrentThread.CurrentCulture = ci;
      Console.WriteLine("Current Culture: {0}",
                        Thread.CurrentThread.CurrentCulture.Name);
      Console.WriteLine("Writing System: {0}",
                        Thread.CurrentThread.CurrentCulture.TextInfo);
   }
}
// The example displays the following output:
//     Current Culture: ru-US
//     Writing System: TextInfo - ru-US

Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      ' Create a custom culture for ru-US.
      Dim car1 As New CultureAndRegionInfoBuilder("ru-US", CultureAndRegionModifiers.None)
      car1.LoadDataFromCultureInfo(CultureInfo.CreateSpecificCulture("ru-RU"))
      car1.LoadDataFromRegionInfo(New RegionInfo("en-US"))
      
      car1.CultureEnglishName = "Russian (United States)"
      car1.CultureNativeName = "русский (США)"
      car1.CurrencyNativeName = "Доллар (США)"
      car1.RegionNativeName = "США"

      ' Register the culture.
      Try
         car1.Register()
      Catch e As InvalidOperationException
         ' Swallow the exception: the culture already is registered.
      End Try
      
      ' Use the custom culture.
      Dim ci As CultureInfo = CultureInfo.CreateSpecificCulture("ru-US")
      Thread.CurrentThread.CurrentCulture = ci
      Console.WriteLine("Current Culture: {0}", 
                        Thread.CurrentThread.CurrentCulture.Name)
      Console.WriteLine("Writing System: {0}", 
                        Thread.CurrentThread.CurrentCulture.TextInfo)
   End Sub
End Module
' The example displays the following output:
'     Current Culture: ru-US
'     Writing System: TextInfo - ru-US