Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase CultureAndRegionInfoBuilder

 

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.

Espacio de nombres:   System.Globalization
Ensamblado:  sysglobl (en sysglobl.dll)

System.Object
  System.Globalization.CultureAndRegionInfoBuilder

[ComVisibleAttribute(false)]
public sealed class CultureAndRegionInfoBuilder

NombreDescripción
System_CAPS_pubmethodCultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Inicializa una nueva instancia de la clase CultureAndRegionInfoBuilder.

NombreDescripción
System_CAPS_pubpropertyAvailableCalendars

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

System_CAPS_pubpropertyCompareInfo

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

System_CAPS_pubpropertyConsoleFallbackUICulture

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.

System_CAPS_pubpropertyCultureEnglishName

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

System_CAPS_pubpropertyCultureName

Obtiene el nombre de la referencia cultural que se crea.

System_CAPS_pubpropertyCultureNativeName

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

System_CAPS_pubpropertyCultureTypes

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

System_CAPS_pubpropertyCurrencyEnglishName

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

System_CAPS_pubpropertyCurrencyNativeName

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

System_CAPS_pubpropertyGeoId

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

System_CAPS_pubpropertyGregorianDateTimeFormat

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

System_CAPS_pubpropertyIetfLanguageTag

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

System_CAPS_pubpropertyIsMetric

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

System_CAPS_pubpropertyISOCurrencySymbol

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

System_CAPS_pubpropertyIsRightToLeft

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

System_CAPS_pubpropertyKeyboardLayoutId

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

System_CAPS_pubpropertyLCID

Obtiene el identificador de referencia cultural del objeto CultureAndRegionInfoBuilder actual.

System_CAPS_pubpropertyNumberFormat

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

System_CAPS_pubpropertyParent

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

System_CAPS_pubpropertyRegionEnglishName

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

System_CAPS_pubpropertyRegionName

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

System_CAPS_pubpropertyRegionNativeName

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

System_CAPS_pubpropertyTextInfo

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

System_CAPS_pubpropertyThreeLetterISOLanguageName

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

System_CAPS_pubpropertyThreeLetterISORegionName

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

System_CAPS_pubpropertyThreeLetterWindowsLanguageName

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

System_CAPS_pubpropertyThreeLetterWindowsRegionName

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

System_CAPS_pubpropertyTwoLetterISOLanguageName

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

System_CAPS_pubpropertyTwoLetterISORegionName

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

NombreDescripción
System_CAPS_pubmethodSystem_CAPS_staticCreateFromLdml(String)

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

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodLoadDataFromCultureInfo(CultureInfo)

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

System_CAPS_pubmethodLoadDataFromRegionInfo(RegionInfo)

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

System_CAPS_pubmethodRegister()

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.

System_CAPS_pubmethodSave(String)

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

System_CAPS_pubmethodToString()

Retorna una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticUnregister(String)

Elimina una referencia cultural personalizada del equipo local.

La CultureInfo clase contiene información específica de la referencia cultural, como el idioma asociado, variante de idioma, país o región, calendario y las convenciones culturales. Esta clase también proporciona instancias específicas de la referencia cultural de la DateTimeFormatInfo, NumberFormatInfo, CompareInfo, y TextInfo las clases, que son necesarias para las operaciones específicas de referencias culturales como mayúsculas y minúsculas, formato y analizar fechas y números y comparar cadenas.

De forma predeterminada, .NET Framework admite CultureInfo objetos que representan un conjunto predefinido de referencias culturales. Para obtener una lista de estas referencias culturales, vea la National Language Support (NLS) API Reference en Go Global Developer Center. La CultureAndRegionInfoBuilder clase le permite crear una referencia cultural personalizada que es completamente nueva o que reemplaza una referencia cultural predefinida. Cuando una referencia cultural personalizada está instalada y registrada en un equipo determinado, se convierte en distingue de predefinidos CultureInfo objetos y se pueden crear instancias y utilizar igual que esos objetos.

System_CAPS_importantImportante

Tenga en cuenta que la CultureAndRegionInfoBuilder clase se encuentra en un ensamblado denominado sysglobl.dll. Compilar correctamente el código que usa este tipo requiere que se agregue una referencia a sysglobl.dll.

Una referencia cultural personalizada se puede registrar en un equipo sólo por un usuario que tenga derechos administrativos en ese equipo. Por consiguiente, las aplicaciones normalmente no cree e instale las referencias culturales personalizadas. En su lugar, puede usar el CultureAndRegionInfoBuilder clase para crear una herramienta especial que un administrador puede usar para crear, instalar y registrar una referencia cultural personalizada. Después de la referencia cultural personalizada está registrada en un equipo, puede usar el CultureInfo clase en la aplicación para crear instancias de la referencia cultural personalizada como haría con una referencia cultural predefinida.

Analizar cadenas de fecha y hora generadas para una referencia cultural personalizada, debe usar la DateTime.ParseExact o DateTime.TryParseExact método en lugar de la DateTime.Parse o DateTime.TryParse método para aumentar la probabilidad de que la operación de análisis se realice correctamente. Una cadena de fecha y hora para una referencia cultural personalizada puede ser complicada y, por tanto, difícil de analizar. El Parse y TryParse métodos intenta analizar una cadena con modelos implícitos de análisis, todos los cuales se pueden producir un error. El TryParseExact (método), en cambio, requiere que la aplicación se designen explícitamente uno o varios modelos exactos de análisis que se lleven a cabo correctamente.

Utiliza la CultureAndRegionInfoBuilder clase definir y asignar el nombre de una referencia cultural personalizada. La referencia cultural personalizada puede ser completamente nueva, una nueva referencia cultural que se basa en una referencia cultural existente (es decir, una referencia cultural complementaria) o una referencia cultural que reemplaza una referencia cultural existente de .NET Framework. En cada caso, los pasos básicos son los mismos:

  1. Crear una instancia de un CultureAndRegionInfoBuilder objeto llamando a su CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) constructor. Para reemplazar una referencia cultural existente, pase el nombre de esa referencia cultural y el CultureAndRegionModifiers.Replacement al constructor valor de enumeración. Para crear una nueva referencia cultural o una referencia cultural complementaria, pase un nombre único de referencia cultural y, o bien el CultureAndRegionModifiers.Neutral o CultureAndRegionModifiers.None valor de enumeración.

    System_CAPS_noteNota

    Si utiliza la CultureAndRegionModifiers.Replacement valor de enumeración para crear una instancia de un CultureAndRegionInfoBuilder objeto, el CultureAndRegionInfoBuilder Propiedades del objeto se rellenan automáticamente con los valores de la CultureInfo objeto que se va a reemplazar.

  2. Si va a crear una referencia cultural nueva o adicional:

    • Rellenar el CultureAndRegionInfoBuilder Propiedades del objeto mediante una llamada a la LoadDataFromCultureInfo método y pasar un CultureInfo objeto cuyos valores de propiedad son similares al nuevo objeto.

    • Rellenar el CultureAndRegionInfoBuilder Propiedades regional del objeto mediante una llamada a la LoadDataFromRegionInfo método y pasar un RegionInfo objeto que representa la región de la referencia cultural personalizada.

  3. Modificar las propiedades de la CultureAndRegionInfoBuilder objeto según sea necesario.

  4. Si va a registrar la referencia cultural personalizada en una rutina diferente, llame a la Save (método). Esto genera un archivo XML que puede cargar y registrar en una rutina de instalación independiente de referencia cultural personalizada.

Si está desarrollando una aplicación de registro para una referencia cultural personalizada que es independiente de la aplicación que crea la referencia cultural, se llama a la CreateFromLdml para cargar el archivo XML que contiene la definición de la referencia cultural personalizada y crear una instancia de la CultureAndRegionInfoBuilder objeto. Para controlar el registro, llame a la Register (método). Para que el registro correctamente, la aplicación que registra la referencia cultural personalizada debe ejecutarse con privilegios administrativos en el sistema de destino; de lo contrario, la llamada a Register produce una UnauthorizedAccessException excepción.

System_CAPS_warningAdvertencia

Datos de referencia cultural pueden diferir entre sistemas. Si está utilizando la CultureAndRegionInfoBuilder clase para crear una referencia cultural personalizada que es uniforme en múltiples sistemas y va a crear la referencia cultural personalizada mediante la carga de datos existente CultureInfo y RegionInfo objetos y personalizarlo, debe desarrollar dos utilidades diferentes. El primero crea la referencia cultural personalizada y lo guarda en un archivo XML. El segundo usa la CreateFromLdml para cargar la referencia cultural personalizada desde un archivo XML y registrarlo en el equipo de destino.

El proceso de registro realiza las siguientes tareas:

  • Crea un archivo .nlp que contiene la información que se define en el CultureAndRegionInfoBuilder objeto.

  • Almacena el archivo .nlp en el directorio del sistema %windir%\Globalization en el equipo de destino. Esto permite que la configuración de la referencia cultural personalizada conservar entre sesiones. (El CultureAndRegionInfoBuilder método requiere privilegios administrativos porque el archivo .nlp se almacena en un directorio del sistema.)

  • Prepara .NET Framework para buscar el directorio del sistema %windir%\Globalization en lugar de una caché interna la próxima vez que hay una solicitud para crear la referencia cultural personalizada nueva.

Cuando una referencia cultural personalizada se ha registrado correctamente, es diferencian de las referencias culturales predefinidos por .NET Framework. La referencia cultural personalizada está disponible hasta que una llamada a la CultureAndRegionInfoBuilder método quita el archivo .nlp desde el equipo local.

Puede crear una instancia de la referencia cultural personalizada en una de las maneras siguientes:

Además, la matriz de CultureInfo objetos devuelto por la CultureInfo.GetCultures método incluye la referencia cultural personalizada.

En el ejemplo siguiente se define una referencia cultural personalizada ru-US que representa el idioma ruso en Estados Unidos. En el ejemplo se define la referencia cultural personalizada mediante la carga de configuración desde el ruso (Rusia) CultureInfo objeto y los Estados Unidos RegionInfo de objetos y, a continuación, Establece el número de CultureAndRegionInfoBuilder Propiedades. En el ejemplo se registra la referencia cultural personalizada y crea una instancia y facilita la referencia cultural del subproceso 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

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: