CultureAndRegionInfoBuilder Clase

Definición

Define una referencia cultural personalizada nueva o que está basada en otra referencia cultural y país o región ya existentes. La referencia cultural personalizada se puede instalar en un equipo y posteriormente ser usada por cualquier aplicación que se ejecute en ese equipo. Esta clase no puede heredarse.

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

Ejemplos

En el ejemplo siguiente se define una referencia cultural ru-US personalizada que representa el idioma ruso en el Estados Unidos. En el ejemplo se define la referencia cultural personalizada cargando la configuración desde el objeto ruso (Rusia) CultureInfo y el objeto de EE. UU. RegionInfo y, a continuación, se establece una serie de CultureAndRegionInfoBuilder propiedades. En el ejemplo se registra la referencia cultural personalizada y, a continuación, se crea una instancia de ella y se convierte en la referencia cultural actual.

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

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para CultureAndRegionInfoBuilder.

Constructores

CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Inicializa una nueva instancia de la clase CultureAndRegionInfoBuilder.

Propiedades

AvailableCalendars

Obtiene o establece una matriz de calendarios admitidos por este objeto CultureAndRegionInfoBuilder.

CompareInfo

Obtiene o establece el objeto CompareInfo que define el modo en que se comparan las cadenas para la referencia cultural.

ConsoleFallbackUICulture

Obtiene o establece una referencia cultural de la interfaz de usuario alternativa apta para las aplicaciones de consola cuando la referencia cultural de la interfaz gráfica de usuario predeterminada no es apropiada.

CultureEnglishName

Obtiene o establece el nombre de la referencia cultural en inglés.

CultureName

Obtiene el nombre de la referencia cultural que se crea.

CultureNativeName

Obtiene o establece el nombre de la referencia cultural en el formato e idioma que la referencia cultural tiene configurados para mostrar en pantalla.

CultureTypes

Obtiene el valor CultureTypes que describe la referencia cultural representada por el objeto CultureAndRegionInfoBuilder actual.

CurrencyEnglishName

Obtiene o establece el nombre, en inglés, de la moneda del país o la región representada por el objeto CultureAndRegionInfoBuilder actual.

CurrencyNativeName

Obtiene o establece el nombre nativo de la moneda del país o la región representada por el objeto CultureAndRegionInfoBuilder actual.

GeoId

Obtiene o establece un número de identificación único para un país, región, ciudad o ubicación geográfica.

GregorianDateTimeFormat

Obtiene o establece un objeto DateTimeFormatInfo que define el formato de fecha y hora según el calendario gregoriano.

IetfLanguageTag

Obtiene o establece un nombre de referencia cultural con un formato según el estándar RFC 4646, "Tags for the Identification of Languages".

IsMetric

Obtiene o establece un valor que indica si el país o la región usan el sistema métrico para las medidas.

ISOCurrencySymbol

Obtiene o establece el símbolo de moneda ISO 4217 de tres caracteres asociado al país o región.

IsRightToLeft

Obtiene o establece la dirección predominante de las líneas de texto en el sistema de escritura asociado al objeto CultureAndRegionInfoBuilder actual.

KeyboardLayoutId

Obtiene o establece el identificador de configuración regional de entrada activo.

LCID

Obtiene el identificador de referencia cultural del objeto CultureAndRegionInfoBuilder actual.

NumberFormat

Obtiene o establece un objeto NumberFormatInfo que define el formato de presentación de números, moneda y porcentaje apropiado para la referencia cultural.

Parent

Obtiene o establece el objeto CultureInfo que representa la referencia cultural principal de la referencia cultural personalizada actual.

RegionEnglishName

Obtiene o establece el nombre completo del país o región en inglés.

RegionName

Obtiene el nombre del país/región para el objeto CultureAndRegionInfoBuilder actual.

RegionNativeName

Obtiene o establece el nombre completo del país/región como lo conocen las personas de esta referencia cultural personalizada.

TextInfo

Obtiene o establece el objeto TextInfo que define el sistema de escritura asociado a esta referencia cultural personalizada.

ThreeLetterISOLanguageName

Obtiene o establece el código ISO 639-2 de tres letras para el idioma de esta referencia cultural personalizada.

ThreeLetterISORegionName

Obtiene o establece el código de tres letras definido en ISO 3166 para el país o región.

ThreeLetterWindowsLanguageName

Obtiene o establece el código de tres letras del idioma tal como se definió en la API de Windows.

ThreeLetterWindowsRegionName

Obtiene o establece el código de tres letras asignado por Windows al país o región representado por la referencia cultural actual.

TwoLetterISOLanguageName

Obtiene o establece el código ISO 639-1 de dos letras del idioma del objeto CultureInfo actual.

TwoLetterISORegionName

Obtiene o establece el código de dos letras definido en ISO 3166 para el país o región.

Métodos

CreateFromLdml(String)

Reconstituye un objeto CultureAndRegionInfoBuilder a partir de un archivo XML especificado que contiene una representación del objeto.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
LoadDataFromCultureInfo(CultureInfo)

Establece las propiedades del objeto CultureAndRegionInfoBuilder actual con las propiedades correspondientes del objeto CultureInfo especificado.

LoadDataFromRegionInfo(RegionInfo)

Establece las propiedades del objeto CultureAndRegionInfoBuilder actual con las propiedades correspondientes del objeto RegionInfo especificado.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
Register()

Almacena el objeto CultureAndRegionInfoBuilder actual como una referencia cultural personalizada en el equipo local y pone esa referencia cultural a disposición de las aplicaciones. Requiere privilegios de administrador.

Save(String)

Escribe una representación XML del objeto CultureAndRegionInfoBuilder actual en el archivo especificado.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
Unregister(String)

Elimina una referencia cultural personalizada del equipo local.

Se aplica a