ResourceWriter Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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) |