CultureAndRegionInfoBuilder Classe

Definição

Define uma cultura personalizada que é nova ou baseada noutra cultura e país/região. A cultura personalizada pode ser instalada num computador e posteriormente usada por qualquer aplicação que esteja a correr nesse computador. Esta 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

Observações

Para mais informações sobre esta API, consulte Observações Suplementares da API para CultureAndRegionInfoBuilder.

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

Construtores

Name Description
CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Inicializa uma nova instância da CultureAndRegionInfoBuilder classe.

Propriedades

Name Description
AvailableCalendars

Obtém ou define um array de calendários suportados por este CultureAndRegionInfoBuilder objeto.

CompareInfo

Obtém ou define o CompareInfo objeto que define como comparar as cordas para a cultura.

ConsoleFallbackUICulture

Obtém ou estabelecem uma cultura alternativa de interface de utilizador adequada para aplicações de consola quando a cultura de interface gráfica padrão é inadequada.

CultureEnglishName

Recebe ou define o nome da cultura em inglês.

CultureName

Recebe o nome da cultura que está a ser criada.

CultureNativeName

Recebe ou define o nome da cultura no formato e na língua que a cultura vai mostrar.

CultureTypes

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

CurrencyEnglishName

Recebe 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 representada pelo objeto atual CultureAndRegionInfoBuilder .

GeoId

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

GregorianDateTimeFormat

Obtém ou define um DateTimeFormatInfo objeto que define o formato das datas e horas de acordo com o calendário gregoriano.

IetfLanguageTag

Recebe ou define um nome de cultura formatado de acordo com a norma RFC 4646, "Tags for the Identification of Languages."

IsMetric

Recebe ou define um valor que indica se o país/região utiliza o sistema métrico para medições.

ISOCurrencySymbol

Recebe ou define o símbolo da 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 escrita associadas ao objeto atual CultureAndRegionInfoBuilder .

KeyboardLayoutId

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

LCID

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

NumberFormat

Recebe ou define um NumberFormatInfo objeto que define o formato culturalmente apropriado para mostrar números, moeda e percentagem.

Parent

Obtém ou define o CultureInfo objeto que representa a cultura-mãe 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 tal como é conhecido pelas pessoas desta cultura costumeira.

TextInfo

Obtém ou define o TextInfo objeto que define o sistema de escrita associado a esta cultura personalizada.

ThreeLetterISOLanguageName

Obtém ou define o código ISO 639-2 de três letras para a língua desta cultura personalizada.

ThreeLetterISORegionName

Recebe 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 da linguagem conforme definido na API do Windows.

ThreeLetterWindowsRegionName

Recebe 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 ISO 639-1 de duas letras para a linguagem do objeto atual CultureInfo .

TwoLetterISORegionName

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

Métodos

Name Description
CreateFromLdml(String)

Reconstitui um CultureAndRegionInfoBuilder objeto a partir de um ficheiro 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 função de hash predefinida.

(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 atual Object.

(Herdado de Object)
Register()

Persiste o objeto atual CultureAndRegionInfoBuilder como uma cultura personalizada no computador local e disponibiliza essa cultura às aplicações. Requer privilégios administrativos.

Save(String)

Escreve uma representação XML do objeto atual CultureAndRegionInfoBuilder no ficheiro especificado.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
Unregister(String)

Apaga uma cultura personalizada do computador local.

Aplica-se a