ResXResourceWriter Třída

Definice

Obor názvů:

System.Resources

Sestavení:

System.Windows.Forms.dll

Zdroj:

ResXResourceWriter.cs

Zapisuje prostředky do souboru prostředku XML (.resx) nebo výstupního datového proudu.

public ref class ResXResourceWriter : IDisposable, System::Resources::IResourceWriter

public class ResXResourceWriter : IDisposable, System.Resources.IResourceWriter

type ResXResourceWriter = class
    interface IResourceWriter
    interface IDisposable

Public Class ResXResourceWriter
Implements IDisposable, IResourceWriter

Dědičnost

Object

ResXResourceWriter

Implementuje

IDisposable IResourceWriter

Příklady

Následující příklad vytvoří soubor .resx s názvem CarResources.resx , který obsahuje šest řetězců, ikonu a dva objekty definované aplikací (dva Automobile objekty). Všimněte si, že Automobile třída, která je definována a vytvořena v příkladu, je označena atributem SerializableAttribute .

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

Poznámky

Zapisuje ResXResourceWriter prostředky ve formátu XML. K zápisu binárního souboru prostředků použijte ResourceWriter.

Prostředky se zadají jako páry název/hodnota pomocí AddResource metody. V názvech prostředků se při vyhledávání rozlišují malá a velká písmena; ale pro snadnější podporu nástrojů pro vytváření a odstranění chyb ResXResourceWriter neumožňuje, aby soubor a.resx měl názvy, které se liší pouze v jednotlivých případech.

Pokud chcete vytvořit soubor a.resx, vytvořte soubor s jedinečným ResXResourceWriter názvem, zavolejte AddResource aspoň jednou, zavolejte Generate soubor prostředků na disk a pak voláním Close zavřete soubor. Volání Close bude v případě potřeby implicitně Generate soubor vyžadovat.

Prostředky nemusí být napsané ve stejném pořadí, v jakém byly přidány.

Další informace o formátu souboru a.resx naleznete v tématu Práce se soubory .resx programově.

Note

Tato třída obsahuje požadavek na propojení a poptávku dědičnosti na úrovni třídy, která se vztahuje na všechny členy. Vyvolá se SecurityException, pokud buď bezprostřední volající, nebo odvozená třída nemá oprávnění plné důvěryhodnosti.

Konstruktory

Name	Description
ResXResourceWriter(Stream, Func<Type,String>)	Inicializuje novou instanci ResXResourceWriter třídy, která zapisuje prostředky do zadaného objektu streamu a nastaví delegát převaděče. Tento delegát umožňuje zápis sestavení prostředků, která cílí na verze .NET Framework před .NET Framework 4 pomocí kvalifikovaných názvů sestavení.
ResXResourceWriter(Stream)	Inicializuje novou instanci ResXResourceWriter třídy, která zapisuje prostředky do zadaného objektu streamu.
ResXResourceWriter(String, Func<Type,String>)	Inicializuje novou instanci třídy ResXResourceWriter, která zapisuje prostředky do zadaného souboru, a nastaví delegáta, který umožňuje zapsat sestavení prostředků, aby se cílové verze .NET Framework před .NET Framework 4 pomocí kvalifikovaných názvů sestavení.
ResXResourceWriter(String)	Inicializuje novou instanci ResXResourceWriter třídy, která zapisuje prostředky do zadaného souboru.
ResXResourceWriter(TextWriter, Func<Type,String>)	Inicializuje novou instanci třídy ResXResourceWriter, která zapisuje prostředky do zadaného objektu TextWriter a nastaví delegáta, který umožňuje zápis sestavení prostředků, která cílová verze rozhraní .NET Framework před .NET Framework 4 pomocí kvalifikovaných názvů sestavení.
ResXResourceWriter(TextWriter)	Inicializuje novou instanci ResXResourceWriter třídy, která zapisuje do zadaného TextWriter objektu.

Pole

Name	Description
BinSerializedObjectMimeType	Určuje výchozí typ obsahu binárního objektu. Toto pole je určeno pouze ke čtení.
ByteArraySerializedObjectMimeType	Určuje výchozí typ obsahu pro objekt pole bajtů. Toto pole je určeno pouze ke čtení.
DefaultSerializedObjectMimeType	Určuje výchozí typ obsahu objektu. Toto pole je určeno pouze ke čtení.
ResMimeType	Určuje typ obsahu prostředku XML. Toto pole je určeno pouze ke čtení.
ResourceSchema	Určuje schéma, které se má použít při zápisu souboru XML. Toto pole je určeno pouze ke čtení.
SoapSerializedObjectMimeType	Určuje typ obsahu objektu SOAP. Toto pole je určeno pouze ke čtení.
Version	Určuje verzi schématu, které odpovídá výstupu XML. Toto pole je určeno pouze ke čtení.

Vlastnosti

Name	Description
BasePath	Získá nebo nastaví základní cestu pro relativní cestu k souboru zadanou v objektu ResXFileRef .

Metody

Name	Description
AddAlias(String, AssemblyName)	Přidá zadaný alias do seznamu aliasů.
AddMetadata(String, Byte[])	Přidá vlastnost návrhu, jejíž hodnota je určena jako pole bajtů do seznamu prostředků k zápisu.
AddMetadata(String, Object)	Přidá vlastnost návrhu, jejíž hodnota je určena jako objekt do seznamu prostředků k zápisu.
AddMetadata(String, String)	Přidá vlastnost návrhu, jejíž hodnota je určena jako řetězec do seznamu prostředků k zápisu.
AddResource(ResXDataNode)	Přidá pojmenovaný prostředek zadaný v objektu ResXDataNode do seznamu prostředků k zápisu.
AddResource(String, Byte[])	Přidá pojmenovaný prostředek určený jako pole bajtů do seznamu prostředků, které se mají zapisovat.
AddResource(String, Object)	Přidá pojmenovaný prostředek zadaný jako objekt do seznamu prostředků k zápisu.
AddResource(String, String)	Přidá prostředek řetězce k prostředkům.
Close()	Uvolní všechny prostředky používané nástrojem ResXResourceWriter.
Dispose()	Uvolní všechny prostředky používané nástrojem ResXResourceWriter.
Dispose(Boolean)	Uvolní nespravované prostředky používané ResXResourceWriter a volitelně uvolní spravované prostředky.
Finalize()	Tento člen přepíše metodu Finalize() .
Generate()	Zapíše všechny prostředky přidané metodou AddResource(String, Byte[]) do výstupního souboru nebo datového proudu.

Viz také

• Práce se soubory .resx prostřednictvím kódu programu