CultureAndRegionInfoBuilder Classe

Definição

Namespace:

System.Globalization

Assembly:

sysglobl.dll

Define uma cultura personalizada nova ou baseada em outra cultura e país/região. A cultura personalizada pode ser instalada em um computador e, em seguida, usada por qualquer aplicativo que esteja em execução nesse computador. Essa classe não pode ser herdada.

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

Exemplos

O exemplo a seguir define uma cultura ru-US personalizada que representa o idioma russo no Estados Unidos. O exemplo define a cultura personalizada carregando configurações do objeto russo (Rússia) CultureInfo e do objeto dos EUA RegionInfo e, em seguida, define várias CultureAndRegionInfoBuilder propriedades. O exemplo registra a cultura personalizada e, em seguida, cria uma instância dela e a torna a 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

Comentários

Para obter mais informações sobre essa API, consulte Comentários de API complementares para CultureAndRegionInfoBuilder.

Construtores

CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Inicializa uma nova instância da classe CultureAndRegionInfoBuilder.

Propriedades

AvailableCalendars	Obtém ou define uma matriz de calendários com suporte por este objeto CultureAndRegionInfoBuilder.
CompareInfo	Obtém ou define o objeto CompareInfo que define como comparar a cultura de cadeias de caracteres.
ConsoleFallbackUICulture	Obtém ou define uma cultura de interface do usuário alternativa adequada para aplicativos de console quando a cultura padrão da interface gráfica do usuário é inapropriada.
CultureEnglishName	Obtém ou define o nome da cultura em inglês.
CultureName	Obtém o nome da cultura sendo criada.
CultureNativeName	Obtém ou define o nome de cultura no formato e idioma que a cultura está configurada para exibir.
CultureTypes	Obtém o valor CultureTypes que descreve a cultura representada pelo objeto CultureAndRegionInfoBuilder atual.
CurrencyEnglishName	Obtém ou define o nome, em inglês, da moeda usada no país/região representado pelo objeto CultureAndRegionInfoBuilder atual.
CurrencyNativeName	Obtém ou define o nome nativo da moeda usada no país/região representado pelo objeto CultureAndRegionInfoBuilder atual.
GeoId	Obtém ou define um número de identificação exclusivo para uma região geográfica, país, cidade ou local.
GregorianDateTimeFormat	Obtém ou define um objeto DateTimeFormatInfo que define o formato de datas e horas de acordo com o calendário gregoriano.
IetfLanguageTag	Obtém ou define um nome de cultura formatado de acordo com a norma RFC 4646, “Marcas para identificação de idiomas”.
IsMetric	Obtém ou define um valor que indica se o país ou a região usa o sistema métrico para medidas.
ISOCurrencySymbol	Obtém ou define o símbolo de moeda de três caracteres ISO 4217 associado ao país/região.
IsRightToLeft	Obtém ou define a direção predominante de linhas de texto no sistema de escrita associado ao objeto CultureAndRegionInfoBuilder atual.
KeyboardLayoutId	Obtém ou define o identificador de localidade de entrada ativo.
LCID	Obtém o identificador de cultura para o objeto CultureAndRegionInfoBuilder atual.
NumberFormat	Obtém ou define um objeto NumberFormatInfo que define o formato culturalmente apropriado de exibição de números, moeda e percentual.
Parent	Obtém ou define o objeto CultureInfo que representa a cultura pai da cultura personalizada atual.
RegionEnglishName	Obtém ou define o nome completo do país/região em inglês.
RegionName	Obtém o nome do país/região do objeto CultureAndRegionInfoBuilder atual.
RegionNativeName	Obtém ou define o nome completo do país/região como conhecido pelas pessoas dessa cultura personalizada.
TextInfo	Obtém ou define o objeto TextInfo que define o sistema de escrita associado a essa cultura personalizada.
ThreeLetterISOLanguageName	Obtém ou define o código de três letras ISO 639-2 para o idioma dessa cultura personalizada.
ThreeLetterISORegionName	Obtém ou define o código de três letras definido na ISO 3166 para o país/região.
ThreeLetterWindowsLanguageName	Obtém ou define o código de três letras do idioma, conforme definido na API do Windows.
ThreeLetterWindowsRegionName	Obtém ou define o código de três letras atribuído pelo Windows para o país/região representado pela cultura personalizada atual.
TwoLetterISOLanguageName	Obtém ou define o código de duas letras ISO 639-1 para o idioma do objeto CultureInfo atual.
TwoLetterISORegionName	Obtém ou define o código de duas letras definido na ISO 3166 para o país/região.

Métodos

CreateFromLdml(String)	Reconstitui um objeto CultureAndRegionInfoBuilder de um arquivo XML especificado que contém uma representação do objeto.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadDataFromCultureInfo(CultureInfo)	Define as propriedades do objeto CultureAndRegionInfoBuilder atual com as propriedades correspondentes do objeto CultureInfo especificado.
LoadDataFromRegionInfo(RegionInfo)	Define as propriedades do objeto CultureAndRegionInfoBuilder atual com as propriedades correspondentes do objeto RegionInfo especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Register()	Persiste o objeto CultureAndRegionInfoBuilder atual como uma cultura personalizada no computador local e disponibiliza essa cultura para os aplicativos. Requer privilégios administrativos.
Save(String)	Grava uma representação XML do objeto CultureAndRegionInfoBuilder atual no arquivo especificado.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Unregister(String)	Exclui uma cultura personalizada do computador local.