ResourceWriter Klasse

Definition

Namespace:

System.Resources

Assembly:

System.Resources.Writer.dll

Quelle:

ResourceWriter.cs

Schreibt Ressourcen im Standardformat des Systems in eine Ausgabedatei oder einen Ausgabestream. Diese Klasse kann nicht vererbt werden.

public ref class ResourceWriter sealed : IDisposable, System::Resources::IResourceWriter

public sealed class ResourceWriter : IDisposable, System.Resources.IResourceWriter

type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter

Public NotInheritable Class ResourceWriter
Implements IDisposable, IResourceWriter

Vererbung

Object

ResourceWriter

Implementiert

IDisposable IResourceWriter

Beispiele

Im folgenden Beispiel werden mehrere Zeichenfolgen in die Datei myResources.resources geschrieben.

using namespace System;
using namespace System::Resources;
int main()
{
   
   // Creates a resource writer.
   IResourceWriter^ writer = gcnew ResourceWriter( "myResources.resources" );
   
   // Adds resources to the resource writer.
   writer->AddResource( "String 1", "First String" );
   writer->AddResource( "String 2", "Second String" );
   writer->AddResource( "String 3", "Third String" );
   
   // Writes the resources to the file or stream, and closes it.
   writer->Close();
}

using System;
using System.Resources;

public class WriteResources {
   public static void Main(string[] args) {

      // Creates a resource writer.
      IResourceWriter writer = new ResourceWriter("myResources.resources");

      // Adds resources to the resource writer.
      writer.AddResource("String 1", "First String");

      writer.AddResource("String 2", "Second String");

      writer.AddResource("String 3", "Third String");

      // Writes the resources to the file or stream, and closes it.
      writer.Close();
   }
}

Imports System.Resources

Public Class WriteResources
    
    Public Shared Sub Main()
        
        ' Creates a resource writer.
        Dim writer As New ResourceWriter("myResources.resources")
        
        ' Adds resources to the resource writer.
        writer.AddResource("String 1", "First String")
        
        writer.AddResource("String 2", "Second String")
        
        writer.AddResource("String 3", "Third String")
        
        ' Writes the resources to the file or stream, and closes it.
        writer.Close()
    End Sub
End Class

Hinweise

ResourceWriter stellt eine Standardimplementierung der IResourceWriter -Schnittstelle bereit. Dadurch können Sie programmgesteuert eine binäre Ressourcendatei (.resources) erstellen.

Ressourcen werden mithilfe der AddResource -Methode als Name- und Wertpaare angegeben. Bei Ressourcennamen wird die Groß-/Kleinschreibung beachtet, wenn sie für Nachschlagevorgänge verwendet werden. Zur einfacheren Unterstützung von Erstellungstools und zur Behebung von Fehlern ist es jedoch nicht zulässig, ResourceWriter dass eine RESOURCES-Datei Namen hat, die nur nach Groß- und Kleinschreibung variieren. Mit ResourceWriter der -Klasse können Sie Zeichenfolgen-, Objekt- und binäre Ressourcen erstellen. Binäre Ressourcen können als Bytearray oder Stream in die Ressourcendatei geschrieben werden.

Wichtig

Dieser Typ implementiert die IDisposable-Schnittstelle. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.

Um eine Ressourcendatei zu erstellen, erstellen Sie eine ResourceWriter mit einem eindeutigen Dateinamen, rufen AddResource Sie mindestens einmal auf, rufen Sie Generate auf, um die Ressourcendatei auf den Datenträger zu schreiben, und rufen Sie dann auf Close , um die Datei zu schließen. Beim Aufrufen Close von wird implizit aufgerufen Generate , wenn Sie nicht explizit aufrufen Generate.

Die Ressourcen werden nicht unbedingt in derselben Reihenfolge geschrieben, in der sie hinzugefügt wurden.

Zum Abrufen von Ressourcen aus einer binären RESOURCES-Datei, die von der ResourceWriter -Klasse erstellt wurde, können Sie die ResourceManager -Klasse verwenden, mit der Sie benannte Ressourcen abrufen können, oder die ResourceReader -Klasse, mit der Sie alle Ressourcen in der Datei auflisten können.

Konstruktoren

ResourceWriter(Stream)	Initialisiert eine neue Instanz der ResourceWriter-Klasse, die die Ressourcen in den angegebenen Stream schreibt.
ResourceWriter(String)	Initialisiert eine neue Instanz der ResourceWriter-Klasse, die die Ressourcen in die angegebene Datei schreibt.

Eigenschaften

TypeNameConverter

Ruft einen Delegaten ab, mit dem mit qualifizierten Assemblynamen Ressourcenassemblys für .NET Framework-Versionen vor .NET Framework 4 geschrieben werden können, oder legt diesen fest.

Methoden

AddResource(String, Byte[])	Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die als Bytearray angegeben ist.
AddResource(String, Object)	Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die als Objekt angegeben ist.
AddResource(String, Stream)	Fügt der Liste zu schreibender Ressourcen eine als Datenstrom angegebene benannte Ressource hinzu.
AddResource(String, Stream, Boolean)	Fügt der Liste zu schreibender Ressourcen eine als Datenstrom angegebene benannte Ressource hinzu und gibt an, ob der Datenstrom geschlossen werden soll, nachdem die Generate()-Methode aufgerufen wurde.
AddResource(String, String)	Fügt der Liste der zu schreibenden Ressourcen eine Zeichenfolgenressource hinzu.
AddResourceData(String, String, Byte[])	Fügt der Liste der zu schreibenden Ressourcen eine Dateneinheit als Ressource hinzu.
Close()	Speichert die Ressourcen im Ausgabestream und schließt diesen anschließend.
Dispose()	Ermöglicht Benutzern das Schließen der Ressourcendatei oder des Streams, um Ressourcen explizit freizugeben.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Generate()	Speichert alle Ressourcen im Standardformat des Systems im Ausgabestream.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• IResourceWriter
• IDisposable
• Ressourcen in Desktop-Apps
• Erstellen von Ressourcendateien für Desktop-Apps