System.Resources.NeutralResourcesLanguageAttribute – třída

Článek
01/08/2024

Tento článek obsahuje doplňující poznámky k referenční dokumentaci pro toto rozhraní API.

V desktopových aplikacích NeutralResourcesLanguageAttribute atribut informuje správce prostředků o výchozí jazykové verzi aplikace a o umístění jejích prostředků. Ve výchozím nastavení jsou prostředky vloženy do sestavení hlavní aplikace a atribut můžete použít následujícím způsobem. Tento příkaz určuje, že výchozí jazykovou verzí aplikace je angličtina (USA).

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

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

Pomocí atributu NeutralResourcesLanguageAttribute můžete také určit, kde ResourceManager lze najít prostředky výchozí jazykové verze zadáním UltimateResourceFallbackLocation hodnoty výčtu v příkazu atributu. Nejčastěji to znamená, že prostředky se nacházejí v satelitním sestavení. Například následující příkaz určuje, že angličtina (USA) je výchozí nebo neutrální jazyková verze aplikace a že její prostředky se nacházejí v satelitním sestavení. Objekt ResourceManager je vyhledá v podadresáři s názvem en-US.

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

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

Tip

K definování výchozí jazykové verze aplikace doporučujeme vždy použít NeutralResourcesLanguageAttribute atribut.

Atribut provádí dvě role:

Pokud jsou prostředky výchozí jazykové verze vložené do hlavního sestavení aplikace a ResourceManager musí načíst prostředky, které patří do stejné jazykové verze jako výchozí jazyková verze, ResourceManager automaticky použije prostředky umístěné v hlavním sestavení místo hledání satelitního sestavení. Tím se obchází obvyklá sonda sestavení, zlepšuje výkon vyhledávání prvního prostředku, který načítáte, a může snížit pracovní sadu. Viz Balení a nasazení prostředků pro proces ResourceManager používá k sondování souborů prostředků.
Pokud jsou prostředky výchozí jazykové verze umístěny v satelitním sestavení místo v hlavním sestavení aplikace, atribut určuje jazykovou verzi a adresář, NeutralResourcesLanguageAttribute ze kterého může modul runtime načíst prostředky.

Aplikace pro Windows 8.x Store

V aplikacích pro Windows 8.x Store, jejichž prostředky jsou načteny a načteny pomocí ResourceManager třídy, atribut definuje neutrální jazykovou verzi, NeutralResourcesLanguageAttribute jejíž prostředky se používají v případě neúspěšné sondy. Nezadá umístění prostředků. Ve výchozím nastavení ResourceManager používá soubor PRI (Package Resource Index) aplikace k vyhledání prostředků výchozí jazykové verze. Neutrální jazyková verze definovaná atributem NeutralResourcesLanguageAttribute se přidá na konec seznamu jazyků uživatelského rozhraní pro simulaci tohoto efektu.

Pokud načtete a načtete prostředky pomocí třídy prostředí Windows Runtime Windows.ApplicationModel.Resources.ResourceLoader nebo typů v oboru názvů Windows.ApplicationModel.Resources.Core, NeutralResourcesLanguageAttribute atribut bude ignorován.

Příklady

Následující příklad používá jednoduchou aplikaci Hello World k ilustraci použití atributu NeutralResourcesLanguageAttribute k definování výchozí nebo záložní jazykové verze. Vyžaduje vytvoření samostatných souborů prostředků pro jazykové verze angličtiny (en), angličtiny (USA) (en-US) a francouzštiny (Francie) (fr-FR). Následující příklad ukazuje obsah textového souboru s názvem ExampleResources.txt pro anglickou jazykovou verzi.

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

Pokud chcete použít soubor prostředků v aplikaci, musíte použít Generátor souborů prostředků (Resgen.exe) k převodu souboru z textového formátu (.txt) na binární formát (.resources), a to následujícím způsobem:

resgen ExampleResources.txt

Při kompilaci aplikace se binární soubor prostředků vloží do hlavního sestavení aplikace.

Následující příklad ukazuje obsah textového souboru s názvem ExampleResources.en-US.txt, který poskytuje prostředky pro jazykovou verzi angličtiny (USA).

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

Textový soubor lze převést na binární soubor prostředků pomocí Generátoru souborů prostředků (ResGen.exe) na příkazovém řádku následujícím způsobem:

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

Binární soubor prostředků by se pak měl zkompilovat do sestavení pomocí Assembly Linkeru (Al.exe) a umístit do podadresáře adresáře aplikace en-US zadáním následujícího příkazu:

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

Následující příklad ukazuje obsah textového souboru s názvem ExampleResources.fr-FR.txt, který poskytuje prostředky pro jazykovou verzi francouzštiny (Francie).

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

Textový soubor lze převést na binární soubor prostředků pomocí ResGen.exe na příkazovém řádku následujícím způsobem:

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

Binární soubor prostředků by se pak měl zkompilovat do sestavení pomocí Assembly Linkeru a umístit do podadresáře fr-FR adresáře aplikace vydáním následujícího příkazu:

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

Následující příklad poskytuje spustitelný kód, který nastaví aktuální jazykovou verzi, vyzve k zadání uživatelského jména a zobrazí lokalizovaný řetězec.

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

Dá se zkompilovat pomocí následujícího příkazu v jazyce Visual Basic:

vbc Example.vb /resource:ExampleResources.resources

nebo pomocí následujícího příkazu v jazyce C#:

csc Example.cs /resource:ExampleResources.resources

System.Resources.NeutralResourcesLanguageAttribute – třída

Aplikace pro Windows 8.x Store

Příklady

Váš názor

Další materiály