ResourceWriter Klasse

Definition

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 ref class ResourceWriter sealed : IDisposable
public ref class ResourceWriter sealed : System::Resources::IResourceWriter
public sealed class ResourceWriter : IDisposable, System.Resources.IResourceWriter
public sealed class ResourceWriter : IDisposable
public sealed class ResourceWriter : System.Resources.IResourceWriter
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter
type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter
type ResourceWriter = class
    interface IDisposable
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
Public NotInheritable Class ResourceWriter
Implements IDisposable, IResourceWriter
Public NotInheritable Class ResourceWriter
Implements IDisposable
Public NotInheritable Class ResourceWriter
Implements IResourceWriter
Vererbung
ResourceWriter
Attribute
Implementiert

Beispiele

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

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ärressourcendatei (.resources) erstellen.

Ressourcen werden mithilfe der -Methode als Name-Wert-Paare AddResource angegeben. Bei Ressourcennamen wird bei suchbasierten Suchen die Schreibung beachtet. Zur einfacheren Unterstützung von Erstellungstools und zur Vermeidung von Fehlern lässt jedoch nicht zu, dass eine RESOURCES-Datei Namen enthält, die nur nach Fall ResourceWriter 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“.

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

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

Um Ressourcen aus einer binären RESOURCES-Datei abzurufen, die von der -Klasse erstellt wurde, können Sie die -Klasse verwenden, mit der Sie benannte Ressourcen abrufen können, oder die -Klasse, mit der Sie alle Ressourcen in der Datei aufzählen ResourceWriter ResourceManager ResourceReader 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)

Gilt für

Siehe auch