Compartilhar via


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, 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
CultureAndRegionInfoBuilder
Atributos

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.

Aplica-se a