Erstellen von Ressourcendateien

Aktualisiert: November 2007

Die Basisklassenbibliothek von .NET Framework stellt im System.Resources-Namespace verschiedene Klassen zur Verfügung, mit denen Sie Ressourcen in Anwendungen erstellen und bearbeiten können. Eine genaue Beschreibung der einzelnen Klassen erhalten Sie durch Klicken auf den entsprechenden Hyperlink. Dadurch wird das jeweilige Referenzthema angezeigt.

Klasse

Beschreibung

IResourceReader-Schnittstelle

Liest Ressourcen aus einem Stream.

IResourceWriter-Schnittstelle

Schreibt Ressourcen in einen Stream.

ResourceReader-Klasse

Liest Ressourcen im Standardbinärdateiformat von Common Language Runtime. Dies ist eine Standardimplementierung der IResourceReader-Schnittstelle.

ResourceWriter-Klasse

Schreibt Ressourcen im Standardbinärdateiformat von Common Language Runtime. Dies ist eine Standardimplementierung der IResourceWriter-Schnittstelle.

ResXResourceReader-Klasse

Stellt die Fähigkeit zur Verfügung, aus RESX-Dateien erstellte Ressourcen abzufragen. Dies ist eine spezielle Implementierung der IResourceReader-Schnittstelle.

ResXResourceWriter-Klasse

Stellt die Fähigkeit zur Verfügung, eine RESX-Datei aus angegebenen Ressourcen zu erstellen. Dies ist eine spezielle Implementierung der IResourceWriter-Schnittstelle. Verwenden Sie Resource File Generator (Resgen.exe), um die RESX-Datei in eine RESOURCES-Datei zu konvertieren.

Ressourcendateien können auf drei verschiedene Arten erstellt werden. Wenn die Ressource nur Zeichenfolgendaten enthält, besteht die einfachste Methode darin, eine Textdatei manuell zu erstellen. Wenn die Ressource Objekte oder eine Kombination von Zeichenfolgen und Objekten enthält, müssen Sie eine Datei im Format .resx oder .resources erstellen. Weitere Informationen zum jeweiligen Dateityp erhalten Sie durch Klicken auf den entsprechenden Hyperlink.

Hinweis:

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

Objekte, die beibehalten werden, müssen serialisierbar sein, um in eine Ressourcendatei geschrieben werden zu können. ..NET Framework-Typen wie string und integer und eine Gruppe von Windows Forms-Typen wie Bitmap, Icon und Image können von teilweise vertrauenswürdigem Code deserialisiert werden. Für die Deserialisierung weiterer Typen muss dem aufrufenden Code die SecurityPermission unter Angabe des SerializationFormatter-Flags gewährt werden.

Auf als privat gekennzeichnete Ressourcen kann nur innerhalb der Assembly zugegriffen werden, in der sie sich befinden. Da die Satellitenassembly keinen Code enthält, sind die Ressourcen, die in dieser privat sind, durch keinen Mechanismus verfügbar. Daher sollten Ressourcen in Satellitenassemblys immer öffentlich sein, damit aus der Hauptassembly auf diese zugegriffen werden kann. Auf die in der Hauptassembly eingebetteten Ressourcen kann von der Hauptassembly zugegriffen werden, unabhängig davon, ob diese privat oder öffentlich sind.

Ihre Anwendung sollte sich niemals auf Ressourcen aus einer Assembly stützen, die Sie nicht erstellt und mit der Anwendung ausgeliefert haben. Abhängigkeiten von Drittanbieterressourcen können ein Fehlschlagen der Anwendung verursachen, da nicht gewährleistet ist, dass diese Ressourcen in einer zukünftigen Version oder Ersetzungs-Service Packs vorhanden sind.

Nur RESOURCES-Dateien sollten in Assemblys und Satellitenassemblys von Common Language Runtime eingebettet werden. Resource File Generator (Resgen.exe) konvertiert Textdateien (.txt) und XML-basierte Ressourcendateien (.resx) mithilfe von Wrappermethoden in RESOURCES-Dateien, die durch die Klassen ResourceReader, ResourceWriter, ResXResourceReader und ResXResourceWriter implementiert sind. Mit Resgen.exe können RESOURCES-Dateien auch zurück in RESX-Dateien bzw. TXT-Dateien konvertiert werden.

Microsoft Windows Software Development Kit (SDK) stellt verschiedene Beispiele für die Arbeit mit RESOURCE-Dateien zur Verfügung. Weitere Informationen finden Sie unter Ressourcen in Anwendungen, im Beispiel zur Lokalisierung in ASP.NET QuickStart und in ASP.NET QuickStart unter Gewusst wie: Ressourcen.

Siehe auch

Konzepte

Ressourcen in Anwendungen

Verpacken und Bereitstellen von Ressourcen

Referenz

System.Resources