CultureAndRegionInfoBuilder Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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. |