Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

NeutralResourcesLanguageAttribute (Clase)

Informa al administrador de recursos de la referencia cultural predeterminada de una aplicación. Esta clase no puede heredarse.

System.Object
  System.Attribute
    System.Resources.NeutralResourcesLanguageAttribute

Espacio de nombres:  System.Resources
Ensamblado:  mscorlib (en mscorlib.dll)

[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple = false)]
public sealed class NeutralResourcesLanguageAttribute : Attribute

El tipo NeutralResourcesLanguageAttribute expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsNeutralResourcesLanguageAttribute(String)Inicializa una nueva instancia de la clase NeutralResourcesLanguageAttribute.
Método públicoNeutralResourcesLanguageAttribute(String, UltimateResourceFallbackLocation)Inicializa una nueva instancia de la clase NeutralResourcesLanguageAttribute con la última ubicación de reserva de recursos especificada.
Arriba

  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCultureNameObtiene el nombre de la referencia cultural.
Propiedad públicaLocationObtiene la ubicación de la clase ResourceManager que se va a utilizar para recuperar recursos neutrales utilizando el proceso de reserva de recursos.
Propiedad públicaTypeIdCuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEqualsInfraestructura. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCodeDevuelve el código hash de esta instancia. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoIsDefaultAttributeCuando se invalida en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para la clase derivada. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkMatch Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privado_Attribute.GetIDsOfNamesAsigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoObtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoCount

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.InvokeProporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).
Arriba

Las aplicaciones de escritorio

En aplicaciones de escritorio, el atributo NeutralResourcesLanguageAttribute informa el Administrador de recursos referencia cultural predeterminada y la ubicación de una aplicación de los recursos. De forma predeterminada, insertan los recursos en el ensamblado principal de la aplicación, y puede utilizar el atributo como sigue. Esta instrucción especifica que el inglés (Estados Unidos) es la referencia cultural predeterminada de la aplicación.


using System.Resources;

[assembly:NeutralResourcesLanguage("en-US")]


También puede utilizar el atributo NeutralResourcesLanguageAttribute para indicar dónde ResourceManager puede encontrar recursos de la referencia cultural predeterminada proporcionando un valor de enumeración UltimateResourceFallbackLocation en la instrucción del atributo. Esto normalmente suele terminada indicar qué recursos residen en un ensamblado satélite. Por ejemplo, la instrucción siguiente especifica que el inglés (Estados Unidos) es el valor predeterminado o la referencia cultural neutra de la aplicación y que sus recursos residen en un ensamblado satélite. El objeto ResourceManager los buscará en un subdirectorio denominado en-US.


using System.Resources;

[assembly:NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]


SugerenciaSugerencia

Se recomienda usar siempre el atributo NeutralResourcesLanguageAttribute para definir la referencia cultural predeterminada de la aplicación.

El atributo realiza dos roles:

  • Si insertan los recursos de la referencia cultural predeterminada en el ensamblado principal de la aplicación y ResourceManager es necesario recuperar recursos que pertenecen a la misma referencia cultural que la referencia cultural predeterminada, ResourceManager utiliza automáticamente los recursos ubicados en el ensamblado principal en lugar de buscar un ensamblado satélite. Esto omite el sondeo habitual de ensamblado, mejora el rendimiento de la búsqueda del primer recurso que se carga, y puede reducir el espacio de trabajo. Vea Empaquetar e implementar recursos en aplicaciones de escritorio para que las aplicaciones de procesamiento ResourceManager sonden para los archivos de recursos.

  • Si los recursos de la referencia cultural predeterminada se encuentran en un ensamblado satélite no en el ensamblado principal de la aplicación, el atributo NeutralResourcesLanguageAttribute especifica la referencia cultural y el directorio del runtime puede cargar recursos.

Aplicaciones de Tienda Windows

En las aplicaciones de Tienda Windows cuyos recursos se cargan y recuperados mediante la clase ResourceManager , el atributo NeutralResourcesLanguageAttribute define la referencia cultural neutra cuyos utilizan recursos en caso de sondeo errores. No especifica la ubicación de los recursos. De forma predeterminada, ResourceManager utiliza el archivo (PRI) de índice de recursos de empaquetado de la aplicación para buscar los recursos de la referencia cultural predeterminada. La referencia cultural neutra definido por el atributo NeutralResourcesLanguageAttribute se agrega al final de la lista de idioma de IU para simular este efecto.

Si carga y recuperar los recursos utilizando la clase Windows.ApplicationModel.Resources.ResourceLoader de Windows en tiempo de ejecución o tipos del espacio de Windows.ApplicationModel.Resources.Core nombres, se omite el atributo NeutralResourcesLanguageAttribute .

El ejemplo siguiente utiliza una sencilla aplicación “Hello world” para mostrar el uso del atributo NeutralResourcesLanguageAttribute para definir una referencia cultural predeterminado o de reserva. Requiere la creación de archivos de recursos independientes para las referencias culturales de inglés (en), inglés (Estados Unidos) (en-us) y francés (Francia) (fr-FR). La siguiente muestra el contenido de un archivo de texto denominado ExampleResources.txt para la referencia cultural Inglés.

# Resources for the default (en) culture.
Greeting=Hello

Para utilizar el archivo de recursos de una aplicación, debe utilizar Generador de archivos de recursos (Resgen.exe) para convertir el archivo de formato de texto (.txt) a un formato binario (.resources) como sigue:

resgen ExampleResources.txt

Cuando se compila la aplicación, el archivo de recursos binario se insertará en el ensamblado principal de la aplicación.

La siguiente muestra el contenido de un archivo de texto denominado ExampleResources.en-US.txt que proporciona recursos para la referencia cultural Inglés (Estados Unidos).

# Resources for the en-US culture.
Greeting=Hi

El archivo de texto se puede convertir en un archivo de recursos binario usando el Generador de archivos de recursos (ResGen.exe) en la línea de comandos como sigue:

resgen ExampleResources.en-US.txt ExampleResources.en-US.resources

El archivo de recursos binario se debe compilar en un ensamblado mediante herramienta Assembly Linker (Al.exe) y colocar en el subdirectorio en-US del directorio de la aplicación ejecutando el siguiente comando:

al /t:lib /embed:ExampleResources.en-US.resources /culture:en-US /out:en-us\Example.resources.dll

La siguiente muestra el contenido de un archivo de texto denominado ExampleResources.fr-FR.txt que proporciona recursos para la referencia cultural Francés (Francia).

# Resources for the fr-FR culture.
Greeting=Bonjour

El archivo de texto se puede convertir en un archivo de recursos binario usando ResGen.exe en la línea de comandos como sigue:

resgen ExampleResources.fr-FR.txt ExampleResources.fr-FR.resources

El archivo de recursos binario se debe compilar en un ensamblado mediante la herramienta Assembly Linker y colocar en el subdirectorio fr-FR del directorio de la aplicación ejecutando el siguiente comando:

al /t:lib /embed:ExampleResources.fr-FR.resources /culture:fr-FR /out:fr-FR\Example.resources.dll

El siguiente ejemplo proporciona el código ejecutable que establece la referencia cultural actual, pide confirmación para el nombre del usuario y muestra una cadena adaptada.


using System;
using System.Globalization;
using System.Reflection;
using System.Resources;
using System.Threading;

[assembly:NeutralResourcesLanguageAttribute("en")]
public class Example
{
   public static void Main()
   {
      // Select the current culture randomly to test resource fallback.
      string[] cultures = { "de-DE", "en-us", "fr-FR" };
      Random rnd = new Random();
      int index = rnd.Next(0, cultures.Length);
      Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultures[index]);      
      Console.WriteLine("The current culture is {0}", 
                        CultureInfo.CurrentUICulture.Name);       

      // Retrieve the resource.
      ResourceManager rm = new ResourceManager("ExampleResources" , 
                                               typeof(Example).Assembly);
      string greeting = rm.GetString("Greeting");

      Console.Write("Enter your name: ");
      string name = Console.ReadLine();
      Console.WriteLine("{0} {1}!", greeting, name);
   }
}


Puede compilar utilizando el siguiente comando en Visual Basic:

vbc Example.vb /resource:ExampleResources.resources

o utilizando el siguiente comando en C#:

csc Example.cs /resource:ExampleResources.resources

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft