NeutralResourcesLanguageAttribute Classe

Definizione

Notifica alla gestione risorse le impostazioni cultura predefinite di un'applicazione.Informs the resource manager of an app's default culture. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class NeutralResourcesLanguageAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class NeutralResourcesLanguageAttribute : Attribute
type NeutralResourcesLanguageAttribute = class
    inherit Attribute
Public NotInheritable Class NeutralResourcesLanguageAttribute
Inherits Attribute
Ereditarietà
NeutralResourcesLanguageAttribute
Attributi

Esempi

Nell'esempio seguente viene usata una semplice app "Hello World" per illustrare l'uso dell'attributo NeutralResourcesLanguageAttribute per definire impostazioni cultura predefinite o di fallback.The following example uses a simple "Hello World" app to illustrate the use of the NeutralResourcesLanguageAttribute attribute to define a default or fallback culture. Richiede la creazione di file di risorse separati per le impostazioni cultura inglese (en), inglese (Stati Uniti) (en-US) e francese (Francia) (fr-FR).It requires the creation of separate resource files for the English (en), English (United States) (en-US), and French (France) (fr-FR) cultures. Di seguito viene illustrato il contenuto di un file di testo denominato ExampleResources. txt per le impostazioni cultura inglesi.The following shows the contents of a text file named ExampleResources.txt for the English culture.

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

Per usare il file di risorse in un'app, è necessario usare il Generatore di file di risorse (Resgen. exe) per convertire il file dal formato di testo (. txt) in un formato binario (con estensione resources) come indicato di seguito:To use the resource file in an app, you must use the Resource File Generator (Resgen.exe) to convert the file from its text (.txt) format to a binary (.resources) format as follows:

resgen ExampleResources.txt  

Quando l'app viene compilata, il file di risorse binario verrà incorporato nell'assembly principale dell'app.When the app is compiled, the binary resource file will be embedded in the main app assembly.

Di seguito viene illustrato il contenuto di un file di testo denominato ExampleResources. en-US. txt che fornisce risorse per le impostazioni cultura inglesi (Stati Uniti).The following shows the contents of a text file named ExampleResources.en-US.txt that provides resources for the English (United States) culture.

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

Il file di testo può essere convertito in un file di risorse binario usando il Generatore di file di risorse (Resgen. exe) nella riga di comando come indicato di seguito:The text file can be converted to a binary resources file by using the Resource File Generator (ResGen.exe) at the command line as follows:

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

Il file di risorse binario deve quindi essere compilato in un assembly usando assembly linker (al. exe) e inserito nella sottodirectory en-US della directory dell'app eseguendo il comando seguente:The binary resource file should then be compiled into an assembly by using Assembly Linker (Al.exe) and placed in the en-US subdirectory of the app directory by issuing the following command:

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

Di seguito viene illustrato il contenuto di un file di testo denominato ExampleResources.fr-fr. txt che fornisce le risorse per le impostazioni cultura francesi (Francia).The following shows the contents of a text file named ExampleResources.fr-FR.txt that provides resources for the French (France) culture.

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

Il file di testo può essere convertito in un file di risorse binario usando ResGen. exe nella riga di comando come indicato di seguito:The text file can be converted to a binary resource file by using ResGen.exe at the command line as follows:

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

Il file di risorse binario deve quindi essere compilato in un assembly usando assembly linker e inserito nella sottodirectory fr-FR della directory dell'app, eseguendo il comando seguente:The binary resources file should then be compiled into an assembly by using Assembly Linker and placed in the fr-FR subdirectory of the app directory by issuing the following command:

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

Nell'esempio seguente viene fornito il codice eseguibile che imposta le impostazioni cultura correnti, richiede il nome dell'utente e visualizza una stringa localizzata.The following example provides the executable code that sets the current culture, prompts for the user's name, and displays a localized string.

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);
   }
}
Imports System.Globalization
Imports System.Reflection
Imports System.Resources
Imports System.Threading 

<Assembly:NeutralResourcesLanguageAttribute("en")>

Module Example
   Public Sub Main()
      ' Select the current culture randomly to test resource fallback.
      Dim cultures() As String = { "de-DE", "en-us", "fr-FR" }
      Dim rnd As New Random()
      Dim index As Integer = 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.
      Dim rm As New ResourceManager("ExampleResources" , GetType(Example).Assembly)
      Dim greeting As String = rm.GetString("Greeting")
      
      Console.Write("Enter your name: ")
      Dim name As String = Console.ReadLine()
      Console.WriteLine("{0} {1}", greeting, name)
   End Sub
End Module

Può essere compilato usando il comando seguente in Visual Basic:It can be compiled by using the following command in Visual Basic:

vbc Example.vb /resource:ExampleResources.resources  

in alternativa, usare il comando seguente C#in:or by using the following command in C#:

csc Example.cs /resource:ExampleResources.resources  

Commenti

App desktopDesktop Apps

Nelle app desktop, l'attributo NeutralResourcesLanguageAttribute informa Resource Manager delle impostazioni cultura predefinite di un'app e il percorso delle relative risorse.In desktop apps, the NeutralResourcesLanguageAttribute attribute informs the resource manager of an app's default culture and the location of its resources. Per impostazione predefinita, le risorse sono incorporate nell'assembly dell'app principale ed è possibile usare l'attributo come indicato di seguito.By default, resources are embedded in the main app assembly, and you can use the attribute as follows. Questa istruzione specifica che la lingua inglese (Stati Uniti) corrisponde alle impostazioni cultura predefinite dell'app.This statement specifies that the English (United States) is the app's default culture.

using System.Resources;

[assembly:NeutralResourcesLanguage("en-US")]
Imports System.Resources

<Assembly:NeutralResourcesLanguage("en-US")>

È anche possibile usare l'attributo NeutralResourcesLanguageAttribute per indicare dove ResourceManager può trovare le risorse delle impostazioni cultura predefinite fornendo un UltimateResourceFallbackLocation valore di enumerazione nell'istruzione Attribute.You can also use the NeutralResourcesLanguageAttribute attribute to indicate where ResourceManager can find the resources of the default culture by providing an UltimateResourceFallbackLocation enumeration value in the attribute statement. Questa operazione viene in genere eseguita per indicare che le risorse si trovano in un assembly satellite.This is most commonly done to indicate that the resources reside in a satellite assembly. L'istruzione seguente, ad esempio, specifica che la lingua inglese (Stati Uniti) corrisponde alle impostazioni cultura predefinite o non associate ad alcun paese e che le relative risorse risiedono in un assembly satellite.For example, the following statement specifies that English (United States) is the app's default or neutral culture and that its resources reside in a satellite assembly. L'oggetto ResourceManager li cercherà in una sottodirectory denominata en-US.The ResourceManager object will look for them in a subdirectory named en-US.

using System.Resources;

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

<Assembly:NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)>

Suggerimento

È consigliabile usare sempre l'attributo NeutralResourcesLanguageAttribute per definire le impostazioni cultura predefinite dell'app.We recommend that you always use the NeutralResourcesLanguageAttribute attribute to define the default culture of your app.

L'attributo esegue due ruoli:The attribute performs two roles:

  • Se le risorse delle impostazioni cultura predefinite sono incorporate nell'assembly principale dell'applicazione e ResourceManager necessario recuperare le risorse che appartengono alle impostazioni cultura predefinite, il ResourceManager usa automaticamente le risorse presenti nell'assembly principale anziché cercare un assembly satellite.If the default culture's resources are embedded in the app's main assembly and ResourceManager has to retrieve resources that belong to the same culture as the default culture, the ResourceManager automatically uses the resources located in the main assembly instead of searching for a satellite assembly. Questo ignora il consueto Probe assembly, migliora le prestazioni di ricerca per la prima risorsa caricata e può ridurre il working set.This bypasses the usual assembly probe, improves lookup performance for the first resource you load, and can reduce your working set. Vedere Creazione del pacchetto e distribuzione delle risorse per il processo ResourceManager USA per verificare la presenza di file di risorse.See Packaging and Deploying Resources for the process ResourceManager uses to probe for resource files.

  • Se le risorse delle impostazioni cultura predefinite si trovano in un assembly satellite anziché nell'assembly principale dell'app, l'attributo NeutralResourcesLanguageAttribute specifica le impostazioni cultura e la directory da cui il runtime può caricare le risorse.If the default culture's resources are located in a satellite assembly rather than in the main app assembly, the NeutralResourcesLanguageAttribute attribute specifies the culture and the directory from which the runtime can load the resources.

Applicazioni Windows 8.x StoreWindows 8.x StoreWindows 8.x StoreWindows 8.x Store Apps

Nelle app Windows 8.x StoreWindows 8.x Store le cui risorse vengono caricate e recuperate usando la classe ResourceManager, l'attributo NeutralResourcesLanguageAttribute definisce le impostazioni cultura non associate ad alcun paese, le cui risorse vengono usate in caso di probe non riuscito.In Windows 8.x StoreWindows 8.x Store apps whose resources are loaded and retrieved by using the ResourceManager class, the NeutralResourcesLanguageAttribute attribute defines the neutral culture whose resources are used in the event of a failed probe. Non specifica il percorso delle risorse.It does not specify the location of the resources. Per impostazione predefinita, ResourceManager usa il file dell'indice delle risorse del pacchetto dell'app (PRI) per individuare le risorse delle impostazioni cultura predefinite.By default, ResourceManager uses the app's package resource index (PRI) file to locate the resources of the default culture. Le impostazioni cultura non associate ad alcun paese definite dall'attributo NeutralResourcesLanguageAttribute vengono aggiunte alla fine dell'elenco della lingua dell'interfaccia utente per simulare questo effetto.The neutral culture that is defined by the NeutralResourcesLanguageAttribute attribute is added to the end of the UI language list to simulate this effect.

Se si caricano e si recuperano risorse usando la classe Windows RuntimeWindows RuntimeWindows. ApplicationModel. resources. ResourceLoader o i tipi nello spazio dei nomi Windows. ApplicationModel. resources. Core , l'attributo NeutralResourcesLanguageAttribute viene ignorato.If you load and retrieve resources by using the Windows RuntimeWindows RuntimeWindows.ApplicationModel.Resources.ResourceLoader class or the types in the Windows.ApplicationModel.Resources.Core namespace, the NeutralResourcesLanguageAttribute attribute is ignored.

Costruttori

NeutralResourcesLanguageAttribute(String)

Inizializza una nuova istanza della classe NeutralResourcesLanguageAttribute.Initializes a new instance of the NeutralResourcesLanguageAttribute class.

NeutralResourcesLanguageAttribute(String, UltimateResourceFallbackLocation)

Inizializza una nuova istanza della classe NeutralResourcesLanguageAttribute con il percorso della risorsa di fallback finale.Initializes a new instance of the NeutralResourcesLanguageAttribute class with the specified ultimate resource fallback location.

Proprietà

CultureName

Ottiene il nome delle impostazioni cultura.Gets the culture name.

Location

Ottiene il percorso della classe ResourceManager da usare per recuperare le risorse neutre usando il processo di fallback delle risorse.Gets the location for the ResourceManager class to use to retrieve neutral resources by using the resource fallback process.

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Ereditato da Attribute)

Metodi

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Ereditato da Attribute)
GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Ereditato da Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Ereditato da Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Ereditato da Attribute)

Si applica a

Vedi anche