Ressourcen im RESOURCES-Dateiformat

Aktualisiert: November 2007

Die ResourceWriter-Klasse dient speziell zum Erstellen von RESOURCES-Dateien. Beachten Sie, dass Sie Objekte nur in RESOURCES-Dateien und in RESX-Dateien speichern können. Es sollten ausschließlich Ressourcendateien im RESOURCES-Dateiformat in eine Ausführungsdatei von Common Language Runtime eingebettet oder in eine Satellitenassembly kompiliert werden. Sie können entweder die ResourceWriter-Klasse direkt aus dem Code erstellen oder Resource File Generator (Resgen.exe) verwenden, um RESOURCES-Dateien zu erstellen.

Hinweis:
Verwenden Sie Ressourcendateien nicht, um Kennwörter, sicherheitsrelevante Informationen oder private Daten zu speichern.

Verwenden der ResourceWriter-Klasse

Mit der ResourceWriter-Klasse können Sie eine RESOURCES-Datei direkt aus Code erstellen. Erstellen Sie zunächst einen ResourceWriter mit einem eindeutigen Namen. Rufen Sie anschließend für jede Zeichenfolge, die Sie zur Datei hinzufügen möchten, die ResourceWriter.AddResource-Methode auf. Schließlich können Sie die ResourceWriter.Close-Methode aufrufen, um die Zeichenfolgen in die Ressourcendatei zu schreiben und ResourceWriter zu schließen. Dieser Prozess wird anhand des folgenden Beispiels veranschaulicht.

Imports System
Imports System.Resources

Public Class SampleClass

    Public Shared Sub Main()
        ' Create a resource writer.
        Dim rw As IResourceWriter
        rw = new ResourceWriter("myStrings.resources")
        ' Add resources to the file.
        rw.AddResource("color1", "red")
        rw.AddResource("color2", "green")
        rw.AddResource("color3", "blue")
        ' Close the ResourceWriter.
        rw.Close()
    End Sub
End Class

using System;
using System.Resources;

public class SampleClass
{
    public static void Main()
    {
        // Create a resource writer.
        IResourceWriter rw = new ResourceWriter("myStrings.resources");
        // Add resources to the file.
        rw.AddResource("color1", "red");
        rw.AddResource("color2", "green");
        rw.AddResource("color3", "blue");
        // Close the ResourceWriter.
        rw.Close();
    }
}

Verwenden von Resgen.exe

Resource File Generator (Resgen.exe) konvertiert TXT-Dateien in RESOURCES-Dateien durch Einschließen der Methoden, die in der ResourceWriter-Klasse implementiert sind. Resgen.exe schließt auch einen ResourceReader ein. Damit können Sie RESOURCES-Dateien wieder zurück in TXT-Dateien konvertieren.

Hinweis:
Beim Lesen einer Textdatei durch Resgen.exe gehen Kommentare verloren und werden nicht in die resultierende RESOURCES-Datei bzw. RESX-Datei geschrieben.

Wenn die Textdatei doppelte Ressourcennamen enthält, gibt Resgen.exe eine Warnung aus und ignoriert die doppelten Namen.

Durch den folgenden Resgen.exe-Befehl wird die Ressourcendatei strings.resources aus der Eingabedatei strings.txt erstellt.

resgen strings.txt

Wenn Sie möchten, dass sich der Name der Ausgabedatei von dem der Eingabedatei unterscheidet, müssen Sie den Namen der Ausgabedatei explizit angeben. Durch den folgenden Befehl wird die Ressourcendatei MyApp.resources aus der Eingabedatei strings.txt erstellt.

resgen strings.txt MyApp.resources

Durch den folgenden Befehl wird die Textdatei strings.txt aus der Eingabedatei strings.resources erstellt. Diese Art Konvertierung darf nur für eine RESOURCES-Datei durchgeführt werden, die ausschließlich Zeichenfolgen enthält. Objektverweise können nicht in die TXT-Datei geschrieben werden.

resgen strings.resources strings.txt

Resgen.exe konvertiert RESX-Dateien in RESOURCES-Dateien durch Einschließen der Methoden, die in der ResourceWriter-Klasse implementiert sind. Resgen.exe schließt auch ResourceReader ein. Damit können RESOURCES-Dateien wieder zurück in RESX-Dateien konvertiert werden.

Durch den folgenden Resgen.exe-Befehl wird die Ressourcendatei items.resources aus der Eingabedatei items.resx erstellt.

resgen items.resx

Durch den folgenden Befehl wird die RESX-Datei items.resx aus der Eingabedatei items.resources erstellt. Beim Konvertieren einer RESX-Datei in eine RESOURCES-Datei werden alle Objekte beibehalten.

resgen items.resources items.resx

Hinweis:
Wenn Resgen.exe aus irgendeinem Grund fehlschlägt, ist der Rückgabewert -1.

Siehe auch

Konzepte

Erstellen von Ressourcendateien

Ressourcen im Textdateiformat

Ressourcen im RESX-Dateiformat

Referenz

Resource File Generator (Resgen.exe)