ResXResourceSet Classe

Définition

Représente toutes les ressources dans un fichier de ressources XML (.resx).Represents all resources in an XML resource (.resx) file.

public ref class ResXResourceSet : System::Resources::ResourceSet
public class ResXResourceSet : System.Resources.ResourceSet
type ResXResourceSet = class
    inherit ResourceSet
Public Class ResXResourceSet
Inherits ResourceSet
Héritage
ResXResourceSet

Exemples

L’exemple suivant instancie un ResXResourceSet objet et illustre comment énumérer ses ressources et récupérer des ressources individuelles par nom.The following example instantiates a ResXResourceSet object and illustrates how to enumerate its resources and retrieve individual resources by name. Pour chaque ressource qu’elle énumère, l’exemple utilise la IDictionaryEnumerator.Key propriété dans un appel à la GetString méthode ou GetObject , selon que la valeur de la ressource est une chaîne ou un objet.For each resource that it enumerates, the example uses the IDictionaryEnumerator.Key property in a call to the GetString or GetObject method, depending on whether the value of the resource is a string or an object.

using System;
using System.Collections;
using System.Drawing;
using System.Resources;

public class Example
{
   public static void Main()
   {
      CreateResXFile();
      
      ResXResourceSet resSet = new ResXResourceSet(@".\StoreResources.resx");
      IDictionaryEnumerator dict = resSet.GetEnumerator();
      while (dict.MoveNext()) {
         string key = (string) dict.Key;
         // Retrieve resource by name.
         if (dict.Value is string)
            Console.WriteLine("{0}: {1}", key, resSet.GetString(key));
         else
            Console.WriteLine("{0}: {1}", key, resSet.GetObject(key));   
      }
   }

   private static void CreateResXFile()
   {
      Bitmap logo = new Bitmap(@".\Logo.bmp");
      ResXDataNode node;
      
      ResXResourceWriter rw = new ResXResourceWriter(@".\StoreResources.resx");
      node = new ResXDataNode("Logo", logo);
      node.Comment = "The corporate logo.";
      rw.AddResource(node); 
      rw.AddResource("AppTitle", "Store Locations");
      node = new ResXDataNode("nColumns", 5);
      node.Comment = "The number of columns in the Store Location table";
      rw.AddResource(node);
      rw.AddResource("City", "City");
      rw.AddResource("State", "State");
      rw.AddResource("Code", "Zip Code");
      rw.AddResource("Telephone", "Phone");
      rw.Generate();
      rw.Close();
   }
}
// The example displays the following output:
//       Telephone: Phone
//       Code: Zip Code
//       State: State
//       City: City
//       nColumns: 5
//       AppTitle: Store Locations
//       Logo: System.Drawing.Bitmap
Imports System.Collections
Imports System.Drawing
Imports System.Resources

Module Example
   Public Sub Main()
      CreateResXFile()
      
      Dim resSet As New ResXResourceSet(".\StoreResources.resx")
      Dim dict As IDictionaryEnumerator = resSet.GetEnumerator()
      Do While dict.MoveNext()
         Dim key As String = CStr(dict.Key)
         ' Retrieve resource by name.
         If typeof dict.Value Is String Then
            Console.WriteLine("{0}: {1}", key, resSet.GetString(key))
         Else
            Console.WriteLine("{0}: {1}", key, resSet.GetObject(key))   
         End If
      Loop
   End Sub
   
   Private Sub CreateResXFile()
      Dim logo As New Bitmap(".\Logo.bmp")
      Dim node As ResXDataNode
      
      Dim rw As New ResXResourceWriter(".\StoreResources.resx")
      node = New ResXDataNode("Logo", logo)
      node.Comment = "The corporate logo."
      rw.AddResource(node) 
      rw.AddResource("AppTitle", "Store Locations")
      node = New ResXDataNode("nColumns", 5)
      node.Comment = "The number of columns in the Store Location table"
      rw.AddResource(node)
      rw.AddResource("City", "City")
      rw.AddResource("State", "State")
      rw.AddResource("Code", "Zip Code")
      rw.AddResource("Telephone", "Phone")
      rw.Generate()
      rw.Close()
   End Sub
End Module
' The example displays the following output:
'       Telephone: Phone
'       Code: Zip Code
'       State: State
'       City: City
'       nColumns: 5
'       AppTitle: Store Locations
'       Logo: System.Drawing.Bitmap

L’exemple appelle une CreateResXFile méthode pour créer le fichier de ressources XML nécessaire.The example calls a CreateResXFile method to create the necessary XML resource file. Il requiert un fichier bitmap nommé logo. bmp dans le répertoire dans lequel l’exemple s’exécute.It requires a bitmap file named Logo.bmp in the directory in which the example is running.

Remarques

La ResXResourceSet classe énumère sur un IResourceReader, charge chaque nom et chaque valeur et les stocke dans une table de hachage.The ResXResourceSet class enumerates over an IResourceReader, loads every name and value, and stores them in a hash table. Vous pouvez ensuite énumérer les ressources dans l' ResXResourceSet objet ou récupérer des ressources individuelles par nom.You can then enumerate the resources in the ResXResourceSet object or retrieve individual resources by name.

Notes

Cette classe contient un SecurityAction.LinkDemand et un SecurityAction.InheritanceDemand au niveau de la classe qui s’applique à tous les membres.This class contains a SecurityAction.LinkDemand and an SecurityAction.InheritanceDemand at the class level that applies to all members. Une SecurityException exception est levée lorsque l’appelant immédiat ou une classe dérivée ne dispose pas d’une autorisation de confiance totale.A SecurityException exception is thrown when the immediate caller or a derived class does not have full-trust permission.

Un ResXResourceSet objet offre un moyen pratique de lire toutes les ressources d’un fichier. resx en mémoire.A ResXResourceSet object provides a convenient way to read all the resources in a .resx file into memory. Vous pouvez utiliser la GetObject méthode pour récupérer une ressource particulière lorsque le fichier. resx a été lu dans une ResXResourceSet instance.You can use the GetObject method to retrieve a particular resource when the .resx file has been read into a ResXResourceSet instance.

Notes pour les héritiers

Les classes dérivées de qui utilisent leur ResXResourceSet propre lecteur et writer de ressources doivent substituer les GetDefaultReader() méthodes et GetDefaultWriter() pour fournir les fonctionnalités appropriées pour ResXResourceSet interpréter l’instance.Derived classes of ResXResourceSet that use their own resource reader and writer should override the GetDefaultReader() and GetDefaultWriter() methods to provide the appropriate functionality for interpreting the ResXResourceSet instance.

Constructeurs

ResXResourceSet(Stream)

Initialise une nouvelle instance de la classe ResXResourceSet en utilisant le ResXResourceReader par défaut du système pour lire les ressources à partir du flux spécifié.Initializes a new instance of the ResXResourceSet class using the system default ResXResourceReader to read resources from the specified stream.

ResXResourceSet(String)

Initialise une nouvelle instance d'une classe ResXResourceSet en utilisant le ResXResourceReader système par défaut qui ouvre et lit les ressources à partir du fichier spécifié.Initializes a new instance of a ResXResourceSet class using the system default ResXResourceReader that opens and reads resources from the specified file.

Champs

Reader

Indique le IResourceReader utilisé pour lire les ressources.Indicates the IResourceReader used to read the resources.

(Hérité de ResourceSet)
Table

Hashtable dans lequel les ressources sont stockées.The Hashtable in which the resources are stored.

(Hérité de ResourceSet)

Méthodes

Close()

Ferme et libère toutes les ressources utilisées par ce ResourceSet.Closes and releases any resources used by this ResourceSet.

(Hérité de ResourceSet)
Dispose()

Libère les ressources (autres que la mémoire) utilisées par l'instance actuelle de ResourceSet.Disposes of the resources (other than memory) used by the current instance of ResourceSet.

(Hérité de ResourceSet)
Dispose(Boolean)

Libère les ressources (autres que la mémoire) associées à l'instance actuelle, en fermant les objets internes managés si nécessaire.Releases resources (other than memory) associated with the current instance, closing internal managed objects if requested.

(Hérité de ResourceSet)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetDefaultReader()

Retourne la classe du lecteur de ressources préféré pour ce type de ResXResourceSet.Returns the preferred resource reader class for this kind of ResXResourceSet.

GetDefaultWriter()

Retourne la classe du writer de ressource préféré pour ce type de ResXResourceSet.Returns the preferred resource writer class for this kind of ResXResourceSet.

GetEnumerator()

Retourne IDictionaryEnumerator qui peut itérer au sein de ResourceSet.Returns an IDictionaryEnumerator that can iterate through the ResourceSet.

(Hérité de ResourceSet)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetObject(String)

Recherche un objet ressource avec le nom spécifié.Searches for a resource object with the specified name.

(Hérité de ResourceSet)
GetObject(String, Boolean)

Recherche un objet ressource avec le nom spécifié sans respecter la casse, si nécessaire.Searches for a resource object with the specified name in a case-insensitive manner, if requested.

(Hérité de ResourceSet)
GetString(String)

Recherche une ressource String avec le nom spécifié.Searches for a String resource with the specified name.

(Hérité de ResourceSet)
GetString(String, Boolean)

Recherche une ressource String avec le nom spécifié sans respecter la casse, si nécessaire.Searches for a String resource with the specified name in a case-insensitive manner, if requested.

(Hérité de ResourceSet)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ReadResources()

Lit toutes les ressources et les stocke dans un Hashtable indiqué dans la propriété Table.Reads all the resources and stores them in a Hashtable indicated in the Table property.

(Hérité de ResourceSet)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()

Retourne un objet IEnumerator pour éviter une condition de concurrence critique avec Dispose.Returns an IEnumerator object to avoid a race condition with Dispose. Ce membre n'est pas destiné à être utilisé directement à partir de votre code.This member is not intended to be used directly from your code.

(Hérité de ResourceSet)

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Sécurité

LinkDemand
pour une confiance totale pour l’appelant immédiat.for full trust for the immediate caller. Cette classe ne peut pas être utilisée par du code d'un niveau de confiance partiel.This class cannot be used by partially trusted code.

InheritanceDemand
pour une confiance totale pour l’appelant immédiat.for full trust for the immediate caller. Cette classe ne peut pas être héritée par du code de confiance partielle.This class cannot be inherited by partially trusted code.

S’applique à

Voir aussi