ResourceWriter Classe

Référence

Définition

Espace de noms:: System.Resources

Assembly:: System.Resources.Writer.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.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 les ressources au format par défaut du système dans un fichier ou un flux de sortie. Cette classe ne peut pas être héritée.

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

Héritage: Object
ResourceWriter

Attributs: ComVisibleAttribute

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' IResourceWriter interface. Elle vous permet de créer par programmation un fichier de ressources binaires (. Resources).

Les ressources sont spécifiées sous la forme de 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 faciliter la prise en charge des outils de création et aider à éliminer les bogues, n' ResourceWriter autorise pas les noms de fichier. Resources qui ne varient que par la casse. La ResourceWriter classe vous permet de créer des ressources de type chaîne, objet et binaire. 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 directement le type Dispose, appelez sa méthode dans un bloc try/catch. Pour la supprimer indirectement, utilisez une construction de langage telle que using (dans C#) ou Using (dans Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet qui implémente 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 de appellera Close implicitement Generate si vous n’appelez pas explicitement Generate .

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

Pour récupérer des ressources à partir d’un fichier. Resources binaire créé par la ResourceWriter classe, vous pouvez utiliser la ResourceManager classe, qui vous permet de récupérer des ressources nommées, ou la ResourceReader classe, qui vous permet d’énumérer toutes les ressources dans le 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 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.

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)	Ajoute une ressource nommée, spécifiée en tant que flux, à 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, String)	Ajoute une ressource de chaîne à la liste de ressources à écrire.
AddResourceData(String, String, Byte[])	Ajoute une unité de données comme ressource dans la liste de ressources à écrire.
Close()	Enregistre les ressources dans le flux de sortie puis ferme ce dernier.
Dispose()	Permet aux utilisateurs de fermer le fichier ou le flux de ressources, libérant de ce fait les ressources de manière explicite.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Generate()	Enregistre toutes les ressources au format par défaut du système dans le 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 à