ResourceWriter ResourceWriter ResourceWriter ResourceWriter Class

Definition

Schreibt Ressourcen im Standardformat des Systems in eine Ausgabedatei oder einen Ausgabestream.Writes resources in the system-default format to an output file or an output stream. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class ResourceWriter sealed : System::Resources::IResourceWriter
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
Public NotInheritable Class ResourceWriter
Implements IResourceWriter
Vererbung
ResourceWriterResourceWriterResourceWriterResourceWriter
Attribute
Implementiert

Beispiele

Im folgenden Beispiel werden mehrere Zeichenfolgen in die Datei myResources.resources geschrieben.The following example writes several strings into the myResources.resources file.

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
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 von der IResourceWriter Schnittstelle.ResourceWriter provides a default implementation of the IResourceWriter interface. Sie können Sie programmgesteuert eine binäre Ressourcendatei (.resources) erstellen.It enables you to programmatically create a binary resource (.resources) file.

Ressourcen werden als Name-Wert-Paaren, die mithilfe von angegeben, dass die AddResource Methode.Resources are specified as name and value pairs using the AddResource method. Ressourcennamen werden Groß-/Kleinschreibung beachtet, bei der Suche wird jedoch zur Unterstützung von problemlos Entwicklungstools und zum Beheben von Problemen ResourceWriter lässt sich nicht auf eine RESOURCES-Datei zu benennen, die sich nur durch Fall unterscheiden.Resource names are case-sensitive when used for lookups, but to more easily support authoring tools and help eliminate bugs, ResourceWriter will not allow a .resources file to have names that vary only by case. Die ResourceWriter -Klasse ermöglicht Ihnen, eine Zeichenfolge, Objekt und binäre Ressourcen zu erstellen.The ResourceWriter class enables you to create string, object, and binary resources. Binäre Ressourcen können in der Ressourcendatei als ein Bytearray oder einen Stream geschrieben werden.Binary resources can be written to the resource file as a byte array or a stream.

Wichtig

Dieser Typ implementiert die IDisposable-Schnittstelle.This type implements the IDisposable interface. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen.When you have finished using the type, you should dispose of it either directly or indirectly. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf.To dispose of the type directly, call its Dispose method in a try/catch block. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Um eine Ressourcendatei zu erstellen, erstellen eine ResourceWriter rufen Sie mit einem eindeutigen Namen, AddResource mindestens einmal aufrufen Generate die Resources-Datei auf Datenträger schreiben, und rufen Sie anschließend Close auf die Datei zu schließen.To create a resources file, create a ResourceWriter with a unique file name, call AddResource at least once, call Generate to write the resources file to disk, and then call Close to close the file. Aufrufen von Close ruft implizit Generate , wenn Sie nicht explizit aufrufen Generate.Calling Close will implicitly call Generate if you do not explicitly call Generate.

Die Ressourcen werden nicht unbedingt in der gleichen Reihenfolge geschrieben werden, die sie hinzugefügt wurden.The resources will not necessarily be written in the same order they were added.

Zum Abrufen von Ressourcen in eine binäre RESOURCES-Datei erstellt die ResourceWriter -Klasse, die Sie verwenden die ResourceManager -Klasse, die benannte Ressourcen abrufen kann, oder die ResourceReader -Klasse, die Sie alle Ressourcen in der Datei aufgelistet werden kann.To retrieve resources from a binary .resources file created by the ResourceWriter class, you can use the ResourceManager class, which lets you retrieve named resources, or the ResourceReader class, which lets you enumerate all the resources in the file.

Konstruktoren

ResourceWriter(Stream) ResourceWriter(Stream) ResourceWriter(Stream) ResourceWriter(Stream)

Initialisiert eine neue Instanz der ResourceWriter-Klasse, die die Ressourcen in den angegebenen Stream schreibt.Initializes a new instance of the ResourceWriter class that writes the resources to the provided stream.

ResourceWriter(String) ResourceWriter(String) ResourceWriter(String) ResourceWriter(String)

Initialisiert eine neue Instanz der ResourceWriter-Klasse, die die Ressourcen in die angegebene Datei schreibt.Initializes a new instance of the ResourceWriter class that writes the resources to the specified file.

Eigenschaften

TypeNameConverter TypeNameConverter TypeNameConverter TypeNameConverter

Ruft einen Delegaten ab, mit dem mit qualifizierten Assemblynamen Ressourcenassemblys für .NET Framework-Versionen vor .NET Framework 4.NET Framework 4 geschrieben werden können, oder legt diesen fest.Gets or sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework prior to the .NET Framework 4.NET Framework 4 by using qualified assembly names.

Methoden

AddResource(String, Byte[]) AddResource(String, Byte[]) AddResource(String, Byte[]) AddResource(String, Byte[])

Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die als Bytearray angegeben ist.Adds a named resource specified as a byte array to the list of resources to be written.

AddResource(String, Object) AddResource(String, Object) AddResource(String, Object) AddResource(String, Object)

Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die als Objekt angegeben ist.Adds a named resource specified as an object to the list of resources to be written.

AddResource(String, Stream) AddResource(String, Stream) AddResource(String, Stream) AddResource(String, Stream)

Fügt der Liste zu schreibender Ressourcen eine als Datenstrom angegebene benannte Ressource hinzu.Adds a named resource specified as a stream to the list of resources to be written.

AddResource(String, Stream, Boolean) AddResource(String, Stream, Boolean) AddResource(String, Stream, Boolean) 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.Adds a named resource specified as a stream to the list of resources to be written, and specifies whether the stream should be closed after the Generate() method is called.

AddResource(String, String) AddResource(String, String) AddResource(String, String) AddResource(String, String)

Fügt der Liste der zu schreibenden Ressourcen eine Zeichenfolgenressource hinzu.Adds a string resource to the list of resources to be written.

AddResourceData(String, String, Byte[]) AddResourceData(String, String, Byte[]) AddResourceData(String, String, Byte[]) AddResourceData(String, String, Byte[])

Fügt der Liste der zu schreibenden Ressourcen eine Dateneinheit als Ressource hinzu.Adds a unit of data as a resource to the list of resources to be written.

Close() Close() Close() Close()

Speichert die Ressourcen im Ausgabestream und schließt diesen anschließend.Saves the resources to the output stream and then closes it.

Dispose() Dispose() Dispose() Dispose()

Ermöglicht Benutzern das Schließen der Ressourcendatei oder des Streams, um Ressourcen explizit freizugeben.Allows users to close the resource file or stream, explicitly releasing resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Generate() Generate() Generate() Generate()

Speichert alle Ressourcen im Standardformat des Systems im Ausgabestream.Saves all resources to the output stream in the system default format.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch