CultureAndRegionInfoBuilder Clase

Definición

Espacio de nombres:

System.Globalization

Ensamblado:

sysglobl.dll

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

Object

CultureAndRegionInfoBuilder

Atributos

ComVisibleAttribute

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 mediante la carga de la configuración del 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 acerca de 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.