NeutralResourcesLanguageAttribute, classe

L'attribut NeutralResourcesLanguageAttribute informe le ResourceManager de la culture de valeur par défaut de l'application, et également informe le ResourceManager que les ressources de la culture par défaut sont recherchées dans l'assembly d'application principal. Lors de la recherche de ressources dans la même culture que la culture par défaut, le ResourceManager utilise automatiquement les ressources situées dans l'assembly principal au lieu de rechercher un assembly satellite. Cela permet d'améliorer les performances de recherche de la première ressource chargée et de réduire votre jeu de travail.

Remarque
Appliquez cet attribut à votre assembly principal en lui passant le nom de la culture par défaut dont les ressources sont incorporées dans l'assembly principal. Vous pouvez également passer un membre de l'énumération UltimateResourceFallbackLocation pour indiquer l'emplacement à partir duquel récupérer des ressources de secours. L'utilisation de cet attribut est fortement recommandée.

L'exemple suivant utilise une application « Hello World » simple pour illustrer l'utilisation de NeutralResourcesLanguageAttribute afin de définir une culture par défaut ou de secours. Il nécessite la création de fichiers de ressources séparés pour les langues anglais (en), anglais (États-Unis) (en-US) et français (France) (fr-FR). Les éléments suivants affichent le contenu d'un fichier texte nommé ExampleResources.txt pour la culture Anglaise.

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

Pour utiliser le fichier de ressources dans une application, vous devez utiliser l'outil Resource File Generator (Resgen.exe) pour le convertir de son format de texte (.txt) au format binaire (.resources). La commande suivante exécute la conversion.

resgen ExampleResources.txt

Lorsque l'application est compilée, le fichier de ressources binaire est incorporé dans l'assembly d'application principal.

Les éléments suivants affichent le contenu d'un fichier texte nommé ExampleResources.en-US.txt qui fournit des ressources pour la culture anglais (États-Unis).

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

Le fichier texte peut être converti en fichier de ressources binaire en utilisant l'outil Resource File Generator (ResGen.exe) sur la ligne de commande comme suit :

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

Le fichier de ressources binaire doit être ensuite compilé dans un assembly à l'aide de Assembly Linker (Al.exe) et placé dans le sous-répertoire en-US du répertoire de l'application en lançant la commande suivante :

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

Les éléments suivants affichent le contenu d'un fichier texte nommé ExampleResources.fr-FR.txt qui fournit des ressources pour la culture français (France).

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

Le fichier texte peut être converti en fichier de ressources binaire en utilisant ResGen.exe sur la ligne de commande comme suit :

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

Le fichier de ressources binaire doit être ensuite compilé dans un assembly à l'aide de Assembly Linker et placé dans le sous-répertoire fr-FR du répertoire de l'application en lançant la commande suivante :

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

L'exemple suivant fournit le code exécutable qui définit la culture actuelle, invite à entrer le nom de l'utilisateur et affiche une chaîne localisée.

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" , 
                                               Assembly.GetExecutingAssembly());
      string greeting = rm.GetString("Greeting");

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

Il peut être compilé en utilisant la commande suivante en Visual Basic :

vbc Example.vb /resource:ExampleResources.resources

ou en utilisant la commande suivante en C# :

csc Example.cs /resource:ExampleResources.resources

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources