NeutralResourcesLanguageAttribute NeutralResourcesLanguageAttribute NeutralResourcesLanguageAttribute NeutralResourcesLanguageAttribute Class

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à
NeutralResourcesLanguageAttributeNeutralResourcesLanguageAttributeNeutralResourcesLanguageAttributeNeutralResourcesLanguageAttribute
Attributi

Esempi

L'esempio seguente usa un'app "Hello World" semplice per illustrare l'utilizzo del NeutralResourcesLanguageAttribute attributo per definire le impostazioni cultura predefinito 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. È necessaria la creazione del file di risorse separati per l'inglese (en), inglese (Stati Uniti) (en-US) e francese (Francia) (fr-FR) le impostazioni cultura.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 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 Resource File Generator Resgen.exe per convertire il file dal formato testo (txt) in un formato di file 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 viene compilata l'app, il file di risorse binario verrà incorporato nell'assembly dell'app principale.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 le risorse per impostazioni cultura inglese (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 con il Resource File Generator ResGen.exe al prompt dei comandi della riga 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 tramite Assembly Linker (Al.exe) e inseriti 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 con 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 utilizzando 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 fornisce il codice eseguibile che imposta le impostazioni cultura correnti, viene richiesto per 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, con il seguente comando nel linguaggio c#:or by using the following command in C#:

csc Example.cs /resource:ExampleResources.resources  

Commenti

App desktopDesktop Apps

Nelle App desktop, il NeutralResourcesLanguageAttribute attributi informa il gestore di risorse delle impostazioni cultura predefinite dell'app e la posizione delle proprie 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 vengono 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 le impostazioni locali inglese (Stati Uniti) le 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 la NeutralResourcesLanguageAttribute attributo per indicare dove ResourceManager possibile trovare le risorse delle impostazioni cultura predefinite, fornendo un UltimateResourceFallbackLocation valore di enumerazione nell'istruzione di attributi.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. Ciò avviene in genere per indicare che le risorse si trovino in un assembly satellite.This is most commonly done to indicate that the resources reside in a satellite assembly. Ad esempio, l'istruzione seguente specifica che inglese (Stati Uniti) è l'app predefinita o impostazioni cultura neutre e che le relative risorse si trovino 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. Il ResourceManager avrà un aspetto per tali oggetti 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 la NeutralResourcesLanguageAttribute attributo 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 svolge due ruoli:The attribute performs two roles:

  • Se l'impostazione predefinita le risorse di lingua sono incorporate nell'assembly principale dell'app e ResourceManager è recuperare le risorse che appartengono alle stesse impostazioni cultura le impostazioni cultura predefinite, il ResourceManager usa automaticamente le risorse che si trovano nell'assembly principale invece ricercare 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. Ciò consente di ignorare il probe di assembly normale, migliora le prestazioni della ricerca per la prima risorsa caricata e riduce il working set.This bypasses the usual assembly probe, improves lookup performance for the first resource you load, and can reduce your working set. Visualizzare Packaging and Deploying Resources 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 di impostazioni cultura predefinite si trovano in un assembly satellite anziché nell'assembly dell'app principale, il NeutralResourcesLanguageAttribute attributo 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 Windows 8.x StoreWindows 8.x Store App le cui risorse vengono caricate e recuperate tramite il ResourceManager (classe), il NeutralResourcesLanguageAttribute attributo definisce la lingua le cui risorse vengono utilizzate in caso di un probe non riuscite.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 file indice (PRI) dell'app per le risorse 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. La lingua definita dal NeutralResourcesLanguageAttribute attributo viene aggiunto alla fine dell'elenco di lingue 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 carica e recuperare le risorse usando il Windows RuntimeWindows Runtime Windows.ApplicationModel.Resources.ResourceLoader classe o i tipi nel Windows.ApplicationModel.Resources.Core spazio dei nomi, il NeutralResourcesLanguageAttribute attributo 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) NeutralResourcesLanguageAttribute(String) NeutralResourcesLanguageAttribute(String) NeutralResourcesLanguageAttribute(String)

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

NeutralResourcesLanguageAttribute(String, UltimateResourceFallbackLocation) NeutralResourcesLanguageAttribute(String, UltimateResourceFallbackLocation) NeutralResourcesLanguageAttribute(String, UltimateResourceFallbackLocation) 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 CultureName CultureName CultureName

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

Location Location Location 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 TypeId TypeId 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.

(Inherited from Attribute)

Metodi

Equals(Object) Equals(Object) Equals(Object) 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.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() 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.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) 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.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _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.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _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.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _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).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _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.

(Inherited from Attribute)

Si applica a

Vedi anche