CultureAndRegionInfoBuilder Classe

Definição

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, posteriormente, usada por qualquer aplicativo 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
CultureAndRegionInfoBuilder
Atributos

Comentários

Para obter mais informações sobre essa API, consulte comentários da API Complementar para CultureAndRegionInfoBuilder.

Exemplo

O exemplo a seguir define uma cultura de 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 define várias CultureAndRegionInfoBuilder propriedades. O exemplo registra a cultura personalizada e, em seguida, cria uma instância 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

Construtores

Nome Description
CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Inicializa uma nova instância da classe CultureAndRegionInfoBuilder.

Propriedades

Nome Description
AvailableCalendars

Obtém ou define uma matriz de calendários compatíveis com esse CultureAndRegionInfoBuilder objeto.

CompareInfo

Obtém ou define o CompareInfo objeto que define como comparar cadeias de caracteres para a cultura.

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 do usuário gráfica é inadequada.

CultureEnglishName

Obtém ou define o nome da cultura em inglês.

CultureName

Obtém o nome da cultura que está sendo criada.

CultureNativeName

Obtém ou define o nome da cultura no formato e idioma que a cultura está definida para exibir.

CultureTypes

Obtém o CultureTypes valor que descreve a cultura representada pelo objeto atual CultureAndRegionInfoBuilder .

CurrencyEnglishName

Obtém ou define o nome, em inglês, da moeda usada no país/região representada pelo objeto atual CultureAndRegionInfoBuilder .

CurrencyNativeName

Obtém ou define o nome nativo da moeda usada no país/região representado pelo objeto atual CultureAndRegionInfoBuilder .

GeoId

Obtém ou define um número de identificação exclusivo para uma região geográfica, país, cidade ou localização.

GregorianDateTimeFormat

Obtém ou define um DateTimeFormatInfo objeto 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 o padrão RFC 4646, "Marcas para a Identificação de Idiomas".

IsMetric

Obtém ou define um valor que indica se o país/região usa o sistema de métricas para medidas.

ISOCurrencySymbol

Obtém ou define o símbolo de moeda ISO 4217 de três caracteres associado ao país/região.

IsRightToLeft

Obtém ou define a direção predominante das linhas de texto no sistema de gravação associado ao objeto atual CultureAndRegionInfoBuilder .

KeyboardLayoutId

Obtém ou define o identificador de localidade de entrada ativo.

LCID

Obtém o identificador de cultura do objeto atual CultureAndRegionInfoBuilder .

NumberFormat

Obtém ou define um NumberFormatInfo objeto que define o formato culturalmente apropriado de exibir números, moeda e porcentagem.

Parent

Obtém ou define o CultureInfo objeto 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 atual CultureAndRegionInfoBuilder .

RegionNativeName

Obtém ou define o nome completo do país/região, conforme conhecido pelas pessoas dessa cultura personalizada.

TextInfo

Obtém ou define o TextInfo objeto que define o sistema de gravação 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 no ISO 3166 para o país/região.

ThreeLetterWindowsLanguageName

Obtém ou define o código de três letras para o idioma, conforme definido na API do Windows.

ThreeLetterWindowsRegionName

Obtém ou define o código de três letras atribuído pelo Windows ao 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 atual CultureInfo .

TwoLetterISORegionName

Obtém ou define o código de duas letras definido no ISO 3166 para o país/região.

Métodos

Nome Description
CreateFromLdml(String)

Reconstitui um CultureAndRegionInfoBuilder objeto 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 atual CultureAndRegionInfoBuilder com as propriedades correspondentes do objeto especificado CultureInfo .

LoadDataFromRegionInfo(RegionInfo)

Define as propriedades do objeto atual CultureAndRegionInfoBuilder com as propriedades correspondentes do objeto especificado RegionInfo .

MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
Register()

Persiste o objeto atual CultureAndRegionInfoBuilder como uma cultura personalizada no computador local e disponibiliza essa cultura para aplicativos. Requer privilégios administrativos.

Save(String)

Grava uma representação XML do objeto atual CultureAndRegionInfoBuilder 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.

Aplica-se a