Ressourcen im Textdateiformat
Textdateien (.txt) können ausschließlich Zeichenfolgenressourcen enthalten. Wenn Sie eine Textdatei im entsprechenden Format speichern, können Sie Zeichenfolgen in drei Codierungsschemas angeben: UTF-16 in der Bytereihenfolge Little-Endian oder Big-Endian oder UTF-8. Wenn Sie beispielsweise deutsche Zeichen speichern und verwenden möchten, speichern Sie die Textdatei in der UTF-8-Codierung und nicht in einer bestimmten ANSI-Codepage. Weitere Informationen über die Verwendung von Codierungen finden Sie unter Unicode in .NET Framework.
Hinweis
Der Resource File Generator (Resgen.exe) behandelt Dateien in der Standardeinstellung als UTF-8.Damit Resgen.exe eine als UTF-16 codierte Datei erkennen kann, müssen Sie am Anfang der Datei eine Unicode-Bytereihenfolgemarkierung (U+FEFF) angeben.
Zusätzlich zu Zeichenfolgeneinträgen können Textdateien auch Kommentare enthalten. Die Anzahl der Einträge, die in einer Textdatei enthalten sein können, ist nicht begrenzt. Sie können auch durchgängig Leerzeilen verwenden, um die Lesbarkeit der Datei zu erleichtern. Beachten Sie, dass umgebende Leerzeichen in einer einzelnen Zeile beim Speichern oder Abfragen nicht übernommen werden. Darüber hinaus ist eine leere Zeichenfolge zulässig.
Wenn die Textdatei doppelte Ressourcennamen enthält, gibt Resgen.exe eine Warnung aus und ignoriert die doppelten Namen.
In der folgenden Tabelle werden die Eingabetypen für Textdateien beschrieben.
Eingabe |
Beschreibung |
|---|---|
;Kommentare |
Sie können optional überall in der Textdatei Kommentare eingebeben. Jedem Kommentar muss ein Semikolon oder ein Nummernzeichen (#) vorangestellt werden. Kommentare dienen zur Erläuterung, wie die Ressourcen organisiert sind. Beispielsweise können Sie die Ressourcen in einer bestimmten Datei mit Kommentaren wie ";Ausnahmen", ";allgemeine Meldungen", ";Textmarken", ";Formularüberschriften" usw. organisieren. Hinweis: Diese Kommentare gehen verloren, wenn eine TXT-Datei in eine RESOURCES-Datei konvertiert wird. |
Name = Wert |
Sie müssen die Zeichenfolgenressourcen als Name/Wertepaar-Einträge angeben, wenn der Name die Ressource beschreibt und der Wert beim Abrufen des Namens durch die ResourceManager.GetString-Methode zurückgegeben wird. Der Name und der Wert müssen durch ein Gleichheitszeichen (=) getrennt werden. Ein Beispiel: "Msg1 = Guten Tag, herzlich willkommen!" Der Wert darf keine Zeilenendemarken enthalten, Sie können jedoch Escapezeichen im C-Stil verwenden, z. B. \n für ein Zeilenende oder \t für einen Tabstopp. Darüber hinaus ist eine leere Zeichenfolge zulässig. Zum Beispiel: MyEmptyString=. |
Sobald alle gewünschten Einträge der Textdatei hinzugefügt wurden, speichern Sie sie unter einem geeigneten Namen mit der Erweiterung .txt.
Hinweis
Verwenden Sie Ressourcendateien nicht, um Kennwörter, sicherheitsrelevante Informationen oder private Daten zu speichern.
Eine TXT-Datei kann nicht in eine Assembly eingebettet werden. Sie müssen die TXT-Datei mithilfe von Resource File Generator (Resgen.exe) in eine RESOURCES-Datei konvertieren. Weitere Informationen finden Sie unter Ressourcen im RESOURCES-Dateiformat.
Siehe auch
Referenz
Resgen.exe (Resource File Generator)