ResXResourceWriter Classe

Référence

Définition

Espace de noms:: System.Resources

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Écrit des ressources dans un fichier de ressources XML (.resx) ou un flux de sortie.

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

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

public class ResXResourceWriter : System.Resources.IResourceWriter

public class ResXResourceWriter : IDisposable, System.Resources.IResourceWriter

type ResXResourceWriter = class
    interface IResourceWriter
    interface IDisposable

Public Class ResXResourceWriter
Implements IResourceWriter

Public Class ResXResourceWriter
Implements IDisposable, IResourceWriter

Héritage: Object
ResXResourceWriter

Implémente: IDisposable IResourceWriter

Exemples

L’exemple suivant crée un fichier .resx nommé CarResources.resx qui stocke six chaînes, une icône et deux objets définis par l’application (deux Automobile objets). Notez que la classe Automobile, qui est définie et instanciée dans l’exemple, est marquée avec l’attribut 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

Remarques

Écrit des ResXResourceWriter ressources au format XML. Pour écrire un fichier de ressources binaire, utilisez ResourceWriter.

Les ressources sont spécifiées en tant que paires nom/valeur à l’aide de la AddResource méthode . Les noms de ressources respectent la casse lorsqu’ils sont utilisés pour les recherches ; mais pour prendre en charge plus facilement les outils de création et aider à éliminer les bogues, ResXResourceWriter ne permet pas à un fichier.resx d’avoir des noms qui varient uniquement selon la casse.

Pour créer un fichier a.resx, créez un ResXResourceWriter avec un nom de fichier unique, appelez AddResource au moins une fois, appelez Generate pour écrire le fichier de ressources sur le disque, puis appelez Close pour fermer le fichier. L’appel Close du fichier est implicitement Generate le cas échéant.

Les ressources ne sont pas nécessairement écrites dans le même ordre qu’elles ont été ajoutées.

Pour plus d’informations sur le format d’un fichier .resx, consultez Utilisation des fichiers .resx par programmation.

Notes

Cette classe contient une demande de lien et une demande d’héritage au niveau de la classe qui s’applique à tous les membres. Une SecurityException valeur est levée lorsque l’appelant immédiat ou la classe dérivée n’a pas l’autorisation de confiance totale.

Constructeurs

ResXResourceWriter(Stream)	Initialise une nouvelle instance de la classe ResXResourceWriter qui écrit les ressources dans l'objet de flux spécifié.
ResXResourceWriter(Stream, Func<Type,String>)	Initialise une nouvelle instance de la classe ResXResourceWriter qui écrit les ressources dans un objet de flux spécifié et définit un délégué de convertisseur. Ce délégué permet d’écrire des assemblys de ressources qui ciblent des versions de .NET Framework antérieures à .NET Framework 4 en utilisant des noms d’assemblys qualifiés.
ResXResourceWriter(String)	Initialise une nouvelle instance de la classe ResXResourceWriter qui écrit les ressources dans le fichier spécifié.
ResXResourceWriter(String, Func<Type,String>)	Initialise une nouvelle instance de la classe ResXResourceWriter qui écrit les ressources dans un fichier spécifié et définit un délégué qui permet d’écrire des assemblys de ressources qui ciblent les versions de .NET Framework antérieures à .NET Framework 4 en utilisant des noms d’assemblys qualifiés.
ResXResourceWriter(TextWriter)	Initialise une nouvelle instance de la classe ResXResourceWriter qui écrit dans l'objet TextWriter spécifié.
ResXResourceWriter(TextWriter, Func<Type,String>)	Initialise une nouvelle instance de la classe ResXResourceWriter qui écrit les ressources dans un objet TextWriter spécifié et définit un délégué qui permet d’écrire des assemblys de ressources qui ciblent les versions de .NET Framework antérieures à .NET Framework 4 en utilisant des noms d’assemblys qualifiés.

Champs

BinSerializedObjectMimeType	Spécifie le type de contenu par défaut d'un objet binaire. Ce champ est en lecture seule.
ByteArraySerializedObjectMimeType	Spécifie le type de contenu par défaut d'un objet de tableau d'octets. Ce champ est en lecture seule.
DefaultSerializedObjectMimeType	Spécifie le type de contenu par défaut d'un objet. Ce champ est en lecture seule.
ResMimeType	Spécifie le type de contenu d'une ressource XML. Ce champ est en lecture seule.
ResourceSchema	Spécifie le schéma à utiliser lors de l'écriture du fichier XML. Ce champ est en lecture seule.
SoapSerializedObjectMimeType	Spécifie le type de contenu d'un objet SOAP. Ce champ est en lecture seule.
Version	Spécifie la version du schéma auquel la sortie XML est conforme. Ce champ est en lecture seule.

Propriétés

BasePath

Obtient ou définit le chemin d'accès de base fichier spécifié dans un objet ResXFileRef.

Méthodes

AddAlias(String, AssemblyName)	Ajoute l'alias spécifié à la liste d'alias.
AddMetadata(String, Byte[])	Ajoute une propriété au moment du design dont la valeur est spécifiée sous la forme d’un tableau d’octets à la liste des ressources à écrire.
AddMetadata(String, Object)	Ajoute une propriété au moment du design dont la valeur est spécifiée sous la forme d'un objet à la liste des ressources à écrire.
AddMetadata(String, String)	Ajoute une propriété au moment du design dont la valeur est spécifiée sous la forme d'une chaîne à la liste des ressources à écrire.
AddResource(ResXDataNode)	Ajoute une ressource nommée spécifiée dans un objet ResXDataNode à la liste des ressources à écrire.
AddResource(String, Byte[])	Ajoute une ressource nommée spécifiée comme un tableau d'octets à la liste des ressources à écrire.
AddResource(String, Object)	Ajoute une ressource nommée spécifiée comme un objet à la liste des ressources à écrire.
AddResource(String, String)	Ajoute une ressource chaîne aux ressources.
Close()	Libère toutes les ressources utilisées par ResXResourceWriter.
Dispose()	Libère toutes les ressources utilisées par ResXResourceWriter.
Dispose(Boolean)	Libère les ressources non managées utilisées par ResXResourceWriter et libère éventuellement les ressources managées.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Finalize()	Ce membre se substitue à la méthode Finalize().
Generate()	Écrit toutes les ressources ajoutées par la méthode AddResource(String, Byte[]) au fichier ou flux de sortie.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à

Voir aussi

Utilisation des fichiers .resx par programmation