Partager via

ResourceWriter Classe

  • Référence

Définition

Espace de noms:
System.Resources
Assembly:
System.Resources.Writer.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
ResourceWriter.cs
Source:
ResourceWriter.cs
Source:
ResourceWriter.cs

É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’interface IResourceWriter . Il vous permet de créer par programmation un fichier de ressources binaires (.resources).

Les ressources sont spécifiées sous 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 prendre en charge plus facilement les outils de création et aider à éliminer les bogues, ResourceWriter il n’est pas permis à un fichier .resources d’avoir des noms qui varient uniquement en fonction de la casse. La ResourceWriter classe 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 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 Close appelle implicitement Generate si vous n’appelez Generatepas explicitement .

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 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 à

Voir aussi