ResourceWriter Classe

Définition

Espace de noms:

System.Resources

Assembly:

System.Resources.Writer.dll

Source:

ResourceWriter.cs

Écrit des ressources au format système par défaut dans un fichier de sortie ou un flux de sortie. Cette classe ne peut pas être héritée.

public ref class ResourceWriter sealed : IDisposable, System::Resources::IResourceWriter

public sealed class ResourceWriter : IDisposable, System.Resources.IResourceWriter

type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter

Public NotInheritable Class ResourceWriter
Implements IDisposable, IResourceWriter

Héritage

Object

ResourceWriter

Implémente

IDisposable IResourceWriter

Exemples

L’exemple suivant écrit plusieurs chaînes dans le fichier myResources.resources.

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

Remarques

ResourceWriter fournit une implémentation par défaut de l’interface IResourceWriter. Il vous permet de créer par programmation un fichier de ressources binaires (.resources).

Les ressources sont spécifiées en tant que paires nom et valeur à l’aide de la méthode AddResource. 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, ResourceWriter n’autorise pas un fichier .resources à avoir des noms qui varient uniquement par cas. La classe ResourceWriter vous permet de créer des ressources de chaîne, d’objet et binaires. Les ressources binaires peuvent être écrites dans le fichier de ressources sous la forme d’un tableau d’octets ou d’un flux.

Important

Ce type implémente l’interface IDisposable. Une fois que vous avez fini d’utiliser le type, vous devez le supprimer directement ou indirectement. Pour supprimer le type directement, appelez sa méthode Dispose dans un bloc try/catch. Pour le supprimer indirectement, utilisez une construction de langage telle que using (en C#) ou Using (en Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet implémentant IDisposable » dans la rubrique de l’interface IDisposable.

Pour créer un fichier de ressources, créez un ResourceWriter 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 appelle implicitement Generate si vous n’appelez pas explicitement Generate.

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

Pour récupérer des ressources à partir d’un fichier .resources binaire créé par la classe ResourceWriter, vous pouvez utiliser la classe ResourceManager, qui vous permet de récupérer des ressources nommées, ou la classe ResourceReader, qui vous permet d’énumérer toutes les ressources du fichier.

Constructeurs

ResourceWriter(Stream)	Initialise une nouvelle instance de la classe ResourceWriter qui écrit les ressources dans le flux fourni.
ResourceWriter(String)	Initialise une nouvelle instance de la classe ResourceWriter qui écrit les ressources dans le fichier spécifié.

Propriétés

TypeNameConverter

Obtient ou définit un délégué qui permet aux assemblys de ressources d’être écrits dans les versions cibles de .NET Framework antérieures à .NET Framework 4 à l’aide de noms d’assemblys qualifiés.

Méthodes

AddResource(String, Byte[])	Ajoute une ressource nommée spécifiée en tant que tableau d’octets à la liste des ressources à écrire.
AddResource(String, Object)	Ajoute une ressource nommée spécifiée en tant qu’objet à la liste des ressources à écrire.
AddResource(String, Stream, Boolean)	Ajoute une ressource nommée spécifiée en tant que flux à la liste des ressources à écrire et spécifie si le flux doit être fermé après l’appel de la méthode Generate().
AddResource(String, Stream)	Ajoute une ressource nommée spécifiée en tant que flux à la liste des ressources à écrire.
AddResource(String, String)	Ajoute une ressource de chaîne à la liste des ressources à écrire.
AddResourceData(String, String, Byte[])	Ajoute une unité de données en tant que ressource à la liste des ressources à écrire.
Close()	Enregistre les ressources dans le flux de sortie, puis la ferme.
Dispose()	Permet aux utilisateurs de fermer le fichier ou le flux de ressources, de libérer explicitement des ressources.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
Generate()	Enregistre toutes les ressources dans le flux de sortie au format système par défaut.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• IResourceWriter
• IDisposable
• ressources dans les applications de bureau
• création de fichiers de ressources pour les applications de bureau