ResXResourceWriter ResXResourceWriter ResXResourceWriter ResXResourceWriter Class

Definition

Schreibt Ressourcen in eine XML-Ressourcendatei (.resx) oder in einen Ausgabestream.Writes resources in an XML resource (.resx) file or an output stream.

public ref class ResXResourceWriter : System::Resources::IResourceWriter
public class ResXResourceWriter : System.Resources.IResourceWriter
type ResXResourceWriter = class
    interface IResourceWriter
    interface IDisposable
Public Class ResXResourceWriter
Implements IResourceWriter
Vererbung
ResXResourceWriterResXResourceWriterResXResourceWriterResXResourceWriter
Implementiert

Beispiele

Das folgende Beispiel erstellt eine RESX-Datei mit dem Namen CarResources.resx speichert sechs Zeichenfolgen, ein Symbol und zwei anwendungsdefinierte Objekte (zwei Automobile Objekte).The following example creates a .resx file named CarResources.resx that stores six strings, an icon, and two application-defined objects (two Automobile objects). Beachten Sie, dass die Klasse Automobile, die im Beispiel definiert und instanziiert wird, mit dem SerializableAttribute-Attribut gekennzeichnet ist.Note that the Automobile class, which is defined and instantiated in the example, is tagged with the SerializableAttribute attribute.

using System;
using System.Drawing;
using System.Resources;

[Serializable()] public class Automobile
{
   private string carMake;
   private string carModel;
   private int carYear;
   private int carDoors;
   private int carCylinders;
   
   public Automobile(string make, string model, int year) :  
                     this(make, model, year, 0, 0)   
   { }
   
   public Automobile(string make, string model, int year, 
                     int doors, int cylinders)
   {                     
      this.carMake = make;
      this.carModel = model;
      this.carYear = year;
      this.carDoors = doors;
      this.carCylinders = cylinders;
   }

   public string Make {
      get { return this.carMake; }
   }       
   
   public string Model {
      get {return this.carModel; }
   }       
   
   public int Year {
      get { return this.carYear; }
   }       
   
   public int Doors {
      get { return this.carDoors; }
   }       
   
   public int Cylinders {
      get { return this.carCylinders; }
   }       
}

public class Example
{
   public static void Main()
   {
      // Instantiate an Automobile object.
      Automobile car1 = new Automobile("Ford", "Model N", 1906, 0, 4);
      Automobile car2 = new Automobile("Ford", "Model T", 1909, 2, 4);
      // Define a resource file named CarResources.resx.
      using (ResXResourceWriter resx = new ResXResourceWriter(@".\CarResources.resx"))
      {
         resx.AddResource("Title", "Classic American Cars");
         resx.AddResource("HeaderString1", "Make");
         resx.AddResource("HeaderString2", "Model");
         resx.AddResource("HeaderString3", "Year");
         resx.AddResource("HeaderString4", "Doors");
         resx.AddResource("HeaderString5", "Cylinders");
         resx.AddResource("Information", SystemIcons.Information); 
         resx.AddResource("EarlyAuto1", car1);  
         resx.AddResource("EarlyAuto2", car2);  
      }
   }
}
Imports System.Drawing
Imports System.Resources

<Serializable()> Public Class Automobile
   Private carMake As String
   Private carModel As String
   Private carYear As Integer
   Private carDoors AS Integer
   Private carCylinders As Integer
   
   Public Sub New(make As String, model As String, year As Integer) 
      Me.New(make, model, year, 0, 0)   
   End Sub
   
   Public Sub New(make As String, model As String, year As Integer, 
                  doors As Integer, cylinders As Integer)
      Me.carMake = make
      Me.carModel = model
      Me.carYear = year
      Me.carDoors = doors
      Me.carCylinders = cylinders
   End Sub

   Public ReadOnly Property Make As String
      Get
         Return Me.carMake
      End Get   
   End Property       
   
   Public ReadOnly Property Model As String
      Get
         Return Me.carModel
      End Get   
   End Property       
   
   Public ReadOnly Property Year As Integer
      Get
         Return Me.carYear
      End Get   
   End Property       
   
   Public ReadOnly Property Doors As Integer
      Get
         Return Me.carDoors
      End Get   
   End Property       
   
   Public ReadOnly Property Cylinders As Integer
      Get
         Return Me.carCylinders
      End Get   
   End Property       
End Class

Module Example
   Public Sub Main()
      ' Instantiate an Automobile object.
      Dim car1 As New Automobile("Ford", "Model N", 1906, 0, 4)
      Dim car2 As New Automobile("Ford", "Model T", 1909, 2, 4)
      ' Define a resource file named CarResources.resx.
      Using resx As New ResXResourceWriter(".\CarResources.resx")
         resx.AddResource("Title", "Classic American Cars")
         resx.AddResource("HeaderString1", "Make")
         resx.AddResource("HeaderString2", "Model")
         resx.AddResource("HeaderString3", "Year")
         resx.AddResource("HeaderString4", "Doors")
         resx.AddResource("HeaderString5", "Cylinders")
         resx.AddResource("Information", SystemIcons.Information) 
         resx.AddResource("EarlyAuto1", car1)
         resx.AddResource("EarlyAuto2", car2)  
      End Using
   End Sub
End Module

Hinweise

Die ResXResourceWriter Ressourcen im XML-Format schreibt.The ResXResourceWriter writes resources in XML format. Verwenden Sie zum Schreiben einer binären Ressourcendatei ResourceWriter.To write a binary resource file, use ResourceWriter.

Ressourcen werden als Name/Wert-Paare, die mit angegeben, dass die AddResource Methode.Resources are specified as name/value pairs using the AddResource method. Ressourcennamen sind Groß-/Kleinschreibung beachtet, wenn für Suchvorgänge verwendet. zum jedoch leichter Unterstützung von Entwicklungstools und zum Beheben von Problemen ResXResourceWriter RESX-Dateien zu benennen, die sich nur durch Fall unterscheiden lässt nicht zu.Resource names are case-sensitive when used for lookups; but to more easily support authoring tools and help eliminate bugs, ResXResourceWriter does not allow a.resx file to have names that vary only by case.

Um RESX-Dateien zu erstellen, erstellen Sie eine ResXResourceWriter 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.resx file, create a ResXResourceWriter 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 wird implizit Generate der Datei, falls erforderlich.Calling Close will implicitly Generate the file if required.

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

Weitere Informationen zum Format von RESX-Dateien finden Sie unter arbeiten mit RESX-Dateien programmgesteuert.For more information on the format of a.resx file, see Working with .resx Files Programmatically.

Hinweis

Diese Klasse enthält einen Linkaufruf und einer vererbungsanforderung auf Klassenebene, die für alle Elemente gilt.This class contains a link demand and an inheritance demand at the class level that applies to all members. Ein SecurityException wird ausgelöst, wenn Sie entweder den unmittelbaren Aufrufer oder die abgeleitete Klasse nicht über volle Vertrauenswürdigkeit verfügt.A SecurityException is thrown when either the immediate caller or the derived class does not have full-trust permission.

Konstruktoren

ResXResourceWriter(Stream) ResXResourceWriter(Stream) ResXResourceWriter(Stream) ResXResourceWriter(Stream)

Initialisiert eine neue Instanz der ResXResourceWriter-Klasse, die die Ressourcen in das angegebene Streamobjekt schreibt.Initializes a new instance of the ResXResourceWriter class that writes the resources to the specified stream object.

ResXResourceWriter(Stream, Func<Type,String>) ResXResourceWriter(Stream, Func<Type,String>) ResXResourceWriter(Stream, Func<Type,String>) ResXResourceWriter(Stream, Func<Type,String>)

Initialisiert eine neue Instanz der ResXResourceWriter-Klasse, die die Ressourcen in ein angegebenes Streamobjekt schreibt und einen Konverterdelegaten festlegt.Initializes a new instance of the ResXResourceWriter class that writes the resources to a specified stream object and sets a converter delegate. Dieser Delegat ermöglicht, dass mithilfe von qualifizierten Assemblynamen Ressourcenassemblys für .NET Framework-Versionen vor .NET Framework 4.NET Framework 4 geschrieben werden können.This delegate enables resource assemblies to be written that target versions of the .NET Framework before the .NET Framework 4.NET Framework 4 by using qualified assembly names.

ResXResourceWriter(String) ResXResourceWriter(String) ResXResourceWriter(String) ResXResourceWriter(String)

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

ResXResourceWriter(String, Func<Type,String>) ResXResourceWriter(String, Func<Type,String>) ResXResourceWriter(String, Func<Type,String>) ResXResourceWriter(String, Func<Type,String>)

Initialisiert eine neue Instanz der ResXResourceWriter-Klasse, die die Ressourcen in eine angegebene Datei schreibt, und legt einen Delegaten fest, der ermöglicht, dass mit qualifizierten Assemblynamen Ressourcenassemblys für .NET Framework-Versionen vor .NET Framework 4.NET Framework 4 geschrieben werden können.Initializes a new instance of the ResXResourceWriter class that writes the resources to a specified file and sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework before the .NET Framework 4.NET Framework 4 by using qualified assembly names.

ResXResourceWriter(TextWriter) ResXResourceWriter(TextWriter) ResXResourceWriter(TextWriter) ResXResourceWriter(TextWriter)

Initialisiert eine neue Instanz der ResXResourceWriter-Klasse, die in das angegebene TextWriter-Objekt schreibt.Initializes a new instance of the ResXResourceWriter class that writes to the specified TextWriter object.

ResXResourceWriter(TextWriter, Func<Type,String>) ResXResourceWriter(TextWriter, Func<Type,String>) ResXResourceWriter(TextWriter, Func<Type,String>) ResXResourceWriter(TextWriter, Func<Type,String>)

Initialisiert eine neue Instanz der ResXResourceWriter-Klasse, die die Ressourcen in ein angegebenes TextWriter-Objekt schreibt, und legt einen Delegaten fest, der ermöglicht, dass mit qualifizierten Assemblynamen Ressourcenassemblys für .NET Framework-Versionen vor .NET Framework 4.NET Framework 4 geschrieben werden können.Initializes a new instance of the ResXResourceWriter class that writes the resources to a specified TextWriter object and sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework before the .NET Framework 4.NET Framework 4 by using qualified assembly names.

Felder

BinSerializedObjectMimeType BinSerializedObjectMimeType BinSerializedObjectMimeType BinSerializedObjectMimeType

Gibt den Standardinhaltstyp für ein binäres Objekt an.Specifies the default content type for a binary object. Dieses Feld ist schreibgeschützt.This field is read-only.

ByteArraySerializedObjectMimeType ByteArraySerializedObjectMimeType ByteArraySerializedObjectMimeType ByteArraySerializedObjectMimeType

Gibt den Standardinhaltstyp für ein Bytearrayobjekt an.Specifies the default content type for a byte array object. Dieses Feld ist schreibgeschützt.This field is read-only.

DefaultSerializedObjectMimeType DefaultSerializedObjectMimeType DefaultSerializedObjectMimeType DefaultSerializedObjectMimeType

Gibt den Standardinhaltstyp für ein Objekt an.Specifies the default content type for an object. Dieses Feld ist schreibgeschützt.This field is read-only.

ResMimeType ResMimeType ResMimeType ResMimeType

Gibt den Inhaltstyp einer XML-Ressource an.Specifies the content type of an XML resource. Dieses Feld ist schreibgeschützt.This field is read-only.

ResourceSchema ResourceSchema ResourceSchema ResourceSchema

Gibt das Schema für das Schreiben der XML-Datei an.Specifies the schema to use in writing the XML file. Dieses Feld ist schreibgeschützt.This field is read-only.

SoapSerializedObjectMimeType SoapSerializedObjectMimeType SoapSerializedObjectMimeType SoapSerializedObjectMimeType

Gibt den Inhaltstyp für ein SOAP-Objekt an.Specifies the content type for a SOAP object. Dieses Feld ist schreibgeschützt.This field is read-only.

Version Version Version Version

Gibt die Version des Schemas an, dem die XML-Ausgabe entspricht.Specifies the version of the schema that the XML output conforms to. Dieses Feld ist schreibgeschützt.This field is read-only.

Eigenschaften

BasePath BasePath BasePath BasePath

Ruft den Basispfad für den in einem ResXFileRef-Objekt angegebenen relativen Pfad ab oder legt diesen fest.Gets or sets the base path for the relative file path specified in a ResXFileRef object.

Methoden

AddAlias(String, AssemblyName) AddAlias(String, AssemblyName) AddAlias(String, AssemblyName) AddAlias(String, AssemblyName)

Fügt den angegebenen Alias einer Liste mit Aliasen hinzu.Adds the specified alias to a list of aliases.

AddMetadata(String, Byte[]) AddMetadata(String, Byte[]) AddMetadata(String, Byte[]) AddMetadata(String, Byte[])

Fügt der Liste der zu schreibenden Ressourcen eine Entwurfszeiteigenschaft hinzu, deren Wert als Bytearray angegeben ist.Adds a design-time property whose value is specified as a byte array to the list of resources to write.

AddMetadata(String, Object) AddMetadata(String, Object) AddMetadata(String, Object) AddMetadata(String, Object)

Fügt der Liste der zu schreibenden Ressourcen eine Entwurfszeiteigenschaft hinzu, deren Wert als ein Objekt angegeben ist.Adds a design-time property whose value is specified as an object to the list of resources to write.

AddMetadata(String, String) AddMetadata(String, String) AddMetadata(String, String) AddMetadata(String, String)

Fügt der Liste der zu schreibenden Ressourcen eine Entwurfszeiteigenschaft hinzu, deren Wert als eine Zeichenfolge angegeben ist.Adds a design-time property whose value is specified as a string to the list of resources to write.

AddResource(ResXDataNode) AddResource(ResXDataNode) AddResource(ResXDataNode) AddResource(ResXDataNode)

Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die in einem ResXDataNode-Objekt angegeben ist.Adds a named resource specified in a ResXDataNode object to the list of resources to write.

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 write.

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 write.

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

Fügt den Ressourcen eine Zeichenfolgenressource hinzu.Adds a string resource to the resources.

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

Gibt alle vom ResXResourceWriter verwendeten Ressourcen frei.Releases all resources used by the ResXResourceWriter.

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

Gibt alle vom ResXResourceWriter verwendeten Ressourcen frei.Releases all resources used by the ResXResourceWriter.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von ResXResourceWriter verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the ResXResourceWriter and optionally releases the managed 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)
Finalize() Finalize() Finalize() Finalize()

Dieser Member überschreibt die Finalize()-Methode.This member overrides the Finalize() method.

Generate() Generate() Generate() Generate()

Schreibt alle von der AddResource(String, Byte[])-Methode hinzugefügten Ressourcen in die Ausgabedatei oder den Ausgabestream.Writes all resources added by the AddResource(String, Byte[]) method to the output file or stream.

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)

Sicherheit

LinkDemand
für volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.for full trust for the immediate caller. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden.This member cannot be used by partially trusted code.

InheritanceDemand
für volle Vertrauenswürdigkeit für erben.for full trust for inheritors. Dieser Member kann nicht von teilweise vertrauenswürdigem Code nicht vererbt werden.This member cannot be inherited by partially trusted code.

Gilt für:

Siehe auch