ResourceWriter Classe
Définition
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 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 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
-
ResourceWriter
- Attributs
- Implémente
Exemples
L’exemple suivant écrit plusieurs chaînes dans le fichier myResources.resources.
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 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 ils n’autorisent pas un fichier .resources à avoir des noms qui varient uniquement par cas. 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, appelez sa Dispose méthode dans un try/catch bloc. Pour la 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 d’interface IDisposable .
Pour créer un fichier de ressources, créez un ResourceWriter fichier avec un nom de fichier unique, appelez AddResource au moins une fois, appelez Generate pour écrire le fichier de ressources sur disque, puis appelez Close pour fermer le fichier. L’appel Close appelle Generate implicitement 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 de la ResourceReader classe, qui vous permet d’énumérer toutes les ressources du fichier.
Constructeurs
| Nom | Description |
|---|---|
| ResourceWriter(Stream) |
Initialise une nouvelle instance de la ResourceWriter classe qui écrit les ressources dans le flux fourni. |
| ResourceWriter(String) |
Initialise une nouvelle instance de la ResourceWriter classe qui écrit les ressources dans le fichier spécifié. |
Propriétés
| Nom | Description |
|---|---|
| TypeNameConverter |
Obtient ou définit un délégué qui permet aux assemblys de ressources d’être écrits qui ciblent les versions de .NET Framework antérieures à .NET Framework 4 à l’aide de noms d’assembly qualifiés. |
Méthodes
| Nom | Description |
|---|---|
| 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 Generate() méthode. |
| 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) |