Číst v angličtině

Sdílet prostřednictvím


Práce se soubory .resx programově

Poznámka

Tento článek se týká rozhraní .NET Framework. Informace, které platí pro .NET 5 nebo novější (včetně .NET Core), najdete v tématu Prostředky v souborech .resx.

Vzhledem k tomu, že soubory prostředků XML (.resx) se musí skládat z dobře definovaného XML, včetně hlavičky, která musí dodržovat konkrétní schéma následované daty ve dvojicích name/value, můžete zjistit, že vytváření těchto souborů je náchylné k chybám. Jako alternativu můžete soubory .resx vytvářet programově pomocí typů a členů v knihovně tříd .NET. Knihovnu tříd .NET můžete také použít k načtení prostředků uložených v souborech .resx. Tento článek vysvětluje, jak pomocí typů a členů v System.Resources oboru názvů pracovat se soubory .resx.

Tento článek popisuje práci se soubory XML (.resx), které obsahují prostředky. Informace o práci s binárními soubory prostředků, které byly vloženy do sestavení, naleznete v tématu ResourceManager.

Upozornění

Existují také způsoby, jak pracovat s jinými soubory .resx než programově. Když do projektu sady Visual Studio přidáte soubor prostředků, sada Visual Studio poskytuje rozhraní pro vytvoření a údržbu souboru .resx a automaticky převede soubor .resx na soubor .resources v době kompilace. K přímé manipulaci se souborem .resx můžete použít také textový editor. Chcete-li se však vyhnout poškození souboru, dávejte pozor, abyste neupravily žádné binární informace, které jsou uloženy v souboru.

Vytvoření souboru .resx

Třídu můžete použít System.Resources.ResXResourceWriter k programovému vytvoření souboru .resx pomocí následujícího postupu:

  1. ResXResourceWriter Vytvořte instanci objektu ResXResourceWriter(String) voláním metody a zadáním názvu souboru .resx. Název souboru musí obsahovat příponu .resx. Pokud vytvoříte instanci objektu ResXResourceWriterusing v bloku, nemusíte explicitně volat metodu ResXResourceWriter.Close v kroku 3.

  2. Zavolejte metodu ResXResourceWriter.AddResource pro každý prostředek, který chcete přidat do souboru. Přetížení této metody použijte k přidání řetězcových, objektových a binárních (bajtových polí) dat. Pokud je prostředek objektem, musí být serializovatelný.

  3. ResXResourceWriter.Close Voláním metody vygenerujte soubor prostředků a uvolněte všechny prostředky. ResXResourceWriter Pokud byl objekt vytvořen v using rámci bloku, prostředky se zapisují do souboru .resx a prostředky používané objektem ResXResourceWriter se uvolní na konci using bloku.

Výsledný soubor .resx má odpovídající hlavičku data a značku pro každý prostředek přidaný metodou ResXResourceWriter.AddResource .

Upozornění

Nepoužívejte soubory prostředků k ukládání hesel, citlivých informací o zabezpečení ani k soukromým datům.

Následující příklad vytvoří soubor .resx s názvem CarResources.resx, který ukládá šest řetězců, ikonu a dva objekty definované aplikací (dva Automobile objekty). Třída Automobile , která je definována a vytvořena v příkladu, je označena atributem SerializableAttribute .

using System;
using System.Drawing;
using System.Resources;

[Serializable()] public class Automobile
{
   private string carMake;
   private string carModel;
   private int carYear;
   private int carDoors;
   private int carCylinders;

   public Automobile(string make, string model, int year) :
                     this(make, model, year, 0, 0)
   { }

   public Automobile(string make, string model, int year,
                     int doors, int cylinders)
   {
      this.carMake = make;
      this.carModel = model;
      this.carYear = year;
      this.carDoors = doors;
      this.carCylinders = cylinders;
   }

   public string Make {
      get { return this.carMake; }
   }

   public string Model {
      get {return this.carModel; }
   }

   public int Year {
      get { return this.carYear; }
   }

   public int Doors {
      get { return this.carDoors; }
   }

   public int Cylinders {
      get { return this.carCylinders; }
   }
}

public class Example
{
   public static void Main()
   {
      // Instantiate an Automobile object.
      Automobile car1 = new Automobile("Ford", "Model N", 1906, 0, 4);
      Automobile car2 = new Automobile("Ford", "Model T", 1909, 2, 4);
      // Define a resource file named CarResources.resx.
      using (ResXResourceWriter resx = new ResXResourceWriter(@".\CarResources.resx"))
      {
         resx.AddResource("Title", "Classic American Cars");
         resx.AddResource("HeaderString1", "Make");
         resx.AddResource("HeaderString2", "Model");
         resx.AddResource("HeaderString3", "Year");
         resx.AddResource("HeaderString4", "Doors");
         resx.AddResource("HeaderString5", "Cylinders");
         resx.AddResource("Information", SystemIcons.Information);
         resx.AddResource("EarlyAuto1", car1);
         resx.AddResource("EarlyAuto2", car2);
      }
   }
}

Tip

Pomocí sady Visual Studio můžete také vytvářet soubory .resx. Visual Studio v době kompilace pomocí Generátoru souborů prostředků (Resgen.exe) převede soubor .resx na binární soubor (.resources) a vloží ho také do sestavení aplikace nebo satelitního sestavení.

Soubor .resx nelze vložit do spustitelného souboru modulu runtime nebo jej zkompilovat do satelitního sestavení. Soubor .resx musíte převést na binární soubor prostředků (.resources) pomocí Generátoru souborů prostředků (Resgen.exe). Výsledný soubor .resources lze pak vložit do sestavení aplikace nebo satelitního sestavení. Další informace najdete v tématu Vytvoření souborů prostředků.

Vytvoření výčtu prostředků

V některých případech můžete chtít načíst všechny prostředky místo konkrétního prostředku ze souboru .resx. K tomu můžete použít System.Resources.ResXResourceReader třídu, která poskytuje enumerátor pro všechny prostředky v souboru .resx. Třída System.Resources.ResXResourceReader implementuje IDictionaryEnumerator, který vrací DictionaryEntry objekt, který představuje konkrétní prostředek pro každou iteraci smyčky. Jeho DictionaryEntry.Key vlastnost vrátí klíč prostředku a jeho DictionaryEntry.Value vlastnost vrátí hodnotu prostředku.

Následující příklad vytvoří ResXResourceReader objekt pro soubor CarResources.resx vytvořený v předchozím příkladu a iteruje prostřednictvím souboru prostředků. Přidá dva Automobile objekty, které jsou definovány v souboru prostředků do System.Collections.Generic.List<T> objektu, a přidá pět z šesti řetězců k objektu SortedList . Hodnoty v objektu SortedList se převedou na pole parametrů, které slouží k zobrazení záhlaví sloupců v konzole. Hodnoty Automobile vlastností se také zobrazí v konzole.

using System;
using System.Collections;
using System.Collections.Generic;
using System.Resources;

public class Example
{
   public static void Main()
   {
      string resxFile = @".\CarResources.resx";
      List<Automobile> autos = new List<Automobile>();
      SortedList headers = new SortedList();

      using (ResXResourceReader resxReader = new ResXResourceReader(resxFile))
      {
         foreach (DictionaryEntry entry in resxReader) {
            if (((string) entry.Key).StartsWith("EarlyAuto"))
               autos.Add((Automobile) entry.Value);
            else if (((string) entry.Key).StartsWith("Header"))
               headers.Add((string) entry.Key, (string) entry.Value);
         }
      }
      string[] headerColumns = new string[headers.Count];
      headers.GetValueList().CopyTo(headerColumns, 0);
      Console.WriteLine("{0,-8} {1,-10} {2,-4}   {3,-5}   {4,-9}\n",
                        headerColumns);
      foreach (var auto in autos)
         Console.WriteLine("{0,-8} {1,-10} {2,4}   {3,5}   {4,9}",
                           auto.Make, auto.Model, auto.Year,
                           auto.Doors, auto.Cylinders);
   }
}
// The example displays the following output:
//       Make     Model      Year   Doors   Cylinders
//
//       Ford     Model N    1906       0           4
//       Ford     Model T    1909       2           4

Načtení konkrétního prostředku

Kromě vytvoření výčtu položek v souboru .resx můžete načíst konkrétní prostředek podle názvu pomocí System.Resources.ResXResourceSet třídy. Metoda ResourceSet.GetString(String) načte hodnotu pojmenovaného řetězce prostředku. Metoda ResourceSet.GetObject(String) načte hodnotu pojmenovaného objektu nebo binárních dat. Metoda vrátí objekt, který se pak musí přetypovat (v jazyce C#) nebo převést (v jazyce Visual Basic) na objekt příslušného typu.

Následující příklad načte řetězec popis formuláře a ikonu podle názvů prostředků. Načte také objekty definované Automobile aplikací použité v předchozím příkladu a zobrazí je v ovládacím DataGridView prvku.

using System;
using System.Collections.Generic;
using System.Drawing;
using System.Resources;
using System.Windows.Forms;

public class CarDisplayApp : Form
{
   private const string resxFile = @".\CarResources.resx";
   Automobile[] cars;

   public static void Main()
   {
      CarDisplayApp app = new CarDisplayApp();
      Application.Run(app);
   }

   public CarDisplayApp()
   {
      // Instantiate controls.
      PictureBox pictureBox = new PictureBox();
      pictureBox.Location = new Point(10, 10);
      this.Controls.Add(pictureBox);
      DataGridView grid = new DataGridView();
      grid.Location = new Point(10, 60);
      this.Controls.Add(grid);

      // Get resources from .resx file.
      using (ResXResourceSet resxSet = new ResXResourceSet(resxFile))
      {
         // Retrieve the string resource for the title.
         this.Text = resxSet.GetString("Title");
         // Retrieve the image.
         Icon image = (Icon) resxSet.GetObject("Information", true);
         if (image != null)
            pictureBox.Image = image.ToBitmap();

         // Retrieve Automobile objects.
         List<Automobile> carList = new List<Automobile>();
         string resName = "EarlyAuto";
         Automobile auto;
         int ctr = 1;
         do {
            auto = (Automobile) resxSet.GetObject(resName + ctr.ToString());
            ctr++;
            if (auto != null)
               carList.Add(auto);
         } while (auto != null);
         cars = carList.ToArray();
         grid.DataSource = cars;
      }
   }
}

Převod souborů .resx na binární soubory .resources

Převod souborů .resx na vložené soubory binárních prostředků (.resources) má významné výhody. I když jsou soubory .resx snadno čitelné a udržovat během vývoje aplikací, jsou zřídka zahrnuty do hotových aplikací. Pokud jsou distribuovány s aplikací, existují jako samostatné soubory kromě spustitelného souboru aplikace a jeho doprovodných knihoven. Naproti tomu soubory .resources jsou vloženy do spustitelného souboru aplikace nebo jeho doprovodných sestavení. Kromě toho u lokalizovaných aplikací spoléhá na soubory .resx v době běhu odpovědnost za zpracování prostředků pro vývojáře. Naproti tomu pokud byla vytvořena sada satelitních sestavení, která obsahují vložené soubory .resources, modul CLR (Common Language Runtime) zpracovává záložní proces prostředku.

Chcete-li převést soubor .resx na soubor .resources , použijte Generátor souborů prostředků (resgen.exe), který má následující základní syntaxi:

 resgen.exe .resxFilename

Výsledkem je binární soubor prostředků, který má stejný název kořenového souboru jako soubor .resx a příponu souboru .resources. Tento soubor je pak možné zkompilovat do spustitelného souboru nebo knihovny v době kompilace. Pokud používáte kompilátor jazyka Visual Basic, vložte do spustitelného souboru aplikace následující syntaxi:

vbc filename .vb -resource: .resourcesFilename

Pokud používáte jazyk C#, syntaxe je následující:

 csc filename .cs -resource: .resourcesFilename

Soubor .resources lze také vložit do satelitního sestavení pomocí assembly Linker (al.exe), který má následující základní syntaxi:

al resourcesFilename -out: assemblyFilename

Viz také