CultureAndRegionInfoBuilder Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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. |