ResXResourceSet Klasse

Definition

Stellt alle Ressourcen in einer XML-Ressourcendatei (.resx) dar.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
Vererbung
ResXResourceSet

Beispiele

Im folgenden Beispiel wird ein ResXResourceSet -Objekt instanziiert und veranschaulicht, wie die Ressourcen aufgezählt und einzelne Ressourcen anhand des Namens abgerufen werden.The following example instantiates a ResXResourceSet object and illustrates how to enumerate its resources and retrieve individual resources by name. Im Beispiel wird für jede aufgezählte Ressource die- IDictionaryEnumerator.Key Eigenschaft in einem aufzurufenden GetString -oder GetObject -Methode verwendet, je nachdem, ob der Wert der Ressource eine Zeichenfolge oder ein Objekt ist.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

Im Beispiel wird eine CreateResXFile -Methode aufgerufen, um die erforderliche XML-Ressourcen Datei zu erstellen.The example calls a CreateResXFile method to create the necessary XML resource file. Hierfür ist eine Bitmapdatei mit dem Namen "Logo. bmp" in dem Verzeichnis erforderlich, in dem das Beispiel ausgeführt wird.It requires a bitmap file named Logo.bmp in the directory in which the example is running.

Hinweise

Die ResXResourceSet -Klasse listet eine IResourceReaderauf, lädt alle Namen und Werte und speichert Sie in einer Hash Tabelle.The ResXResourceSet class enumerates over an IResourceReader, loads every name and value, and stores them in a hash table. Anschließend können Sie die Ressourcen im ResXResourceSet Objekt auflisten oder einzelne Ressourcen nach dem Namen abrufen.You can then enumerate the resources in the ResXResourceSet object or retrieve individual resources by name.

Hinweis

Diese Klasse enthält eine SecurityAction.LinkDemand und eine SecurityAction.InheritanceDemand auf Klassenebene, die für alle Member gilt.This class contains a SecurityAction.LinkDemand and an SecurityAction.InheritanceDemand at the class level that applies to all members. Eine SecurityException -Ausnahme wird ausgelöst, wenn der unmittelbare Aufrufer oder eine abgeleitete Klasse nicht über die Berechtigung für volle Vertrauenswürdigkeit verfügt.A SecurityException exception is thrown when the immediate caller or a derived class does not have full-trust permission.

Ein ResXResourceSet -Objekt bietet eine bequeme Möglichkeit, alle Ressourcen in einer RESX-Datei in den Arbeitsspeicher zu lesen.A ResXResourceSet object provides a convenient way to read all the resources in a .resx file into memory. Sie können die GetObject -Methode verwenden, um eine bestimmte Ressource abzurufen, wenn die RESX-Datei in eine ResXResourceSet -Instanz gelesen wurde.You can use the GetObject method to retrieve a particular resource when the .resx file has been read into a ResXResourceSet instance.

Hinweise für Vererber

Abgeleitete Klassen ResXResourceSet von, die ihren eigenen Ressourcen Reader und Writer verwenden, GetDefaultReader() sollten GetDefaultWriter() die-Methode und die-Methode überschreiben ResXResourceSet , um die entsprechende Funktionalität zum Interpretieren der Instanz bereitzustellenDerived 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.

Konstruktoren

ResXResourceSet(Stream)

Initialisiert mit dem als Standard festgelegten ResXResourceSet eine neue Instanz der ResXResourceReader-Klasse, um Ressourcen aus dem angegebenen Stream zu lesen.Initializes a new instance of the ResXResourceSet class using the system default ResXResourceReader to read resources from the specified stream.

ResXResourceSet(String)

Initialisiert mit dem als Standard festgelegten ResXResourceSet eine neue Instanz der ResXResourceReader-Klasse, um Ressourcen aus der angegebenen Datei zu öffnen und zu lesen.Initializes a new instance of a ResXResourceSet class using the system default ResXResourceReader that opens and reads resources from the specified file.

Felder

Reader

Gibt den IResourceReader zum Lesen der Ressourcen an.Indicates the IResourceReader used to read the resources.

(Geerbt von ResourceSet)
Table

Die Hashtable, in der die Ressourcen gespeichert sind.The Hashtable in which the resources are stored.

(Geerbt von ResourceSet)

Methoden

Close()

Schließt alle von diesem ResourceSet verwendeten Ressourcen und gibt diese frei.Closes and releases any resources used by this ResourceSet.

(Geerbt von ResourceSet)
Dispose()

Gibt die durch die aktuelle Instanz von ResourceSet verwendeten Ressourcen frei, mit Ausnahme des Speichers.Disposes of the resources (other than memory) used by the current instance of ResourceSet.

(Geerbt von ResourceSet)
Dispose(Boolean)

Gibt die der aktuellen Instanz zugeordneten Ressourcen (mit Ausnahme des Speichers) frei und schließt auf Anforderung die intern verwalteten Objekte.Releases resources (other than memory) associated with the current instance, closing internal managed objects if requested.

(Geerbt von ResourceSet)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetDefaultReader()

Gibt die bevorzugte Klasse von Ressourcenreadern für diese Art von ResXResourceSet zurück.Returns the preferred resource reader class for this kind of ResXResourceSet.

GetDefaultWriter()

Gibt die bevorzugte Klasse von Ressourcenwritern für diese Art von ResXResourceSet zurück.Returns the preferred resource writer class for this kind of ResXResourceSet.

GetEnumerator()

Gibt einen IDictionaryEnumerator zurück, der die ResourceSet durchlaufen kann.Returns an IDictionaryEnumerator that can iterate through the ResourceSet.

(Geerbt von ResourceSet)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetObject(String)

Sucht nach einem Ressourcenobjekt mit dem angegebenen Namen.Searches for a resource object with the specified name.

(Geerbt von ResourceSet)
GetObject(String, Boolean)

Sucht auf Anforderung unter Berücksichtigung der Groß- und Kleinschreibung nach einem Ressourcenobjekt mit dem angegebenen Namen.Searches for a resource object with the specified name in a case-insensitive manner, if requested.

(Geerbt von ResourceSet)
GetString(String)

Sucht nach einer String-Ressource mit dem angegebenen Namen.Searches for a String resource with the specified name.

(Geerbt von ResourceSet)
GetString(String, Boolean)

Sucht auf Anforderung ohne Berücksichtigung der Groß- und Kleinschreibung nach einer String-Ressource mit dem angegebenen Namen.Searches for a String resource with the specified name in a case-insensitive manner, if requested.

(Geerbt von ResourceSet)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ReadResources()

Liest alle Ressourcen und speichert diese in einer Hashtable, die in der Table-Eigenschaft angegeben ist.Reads all the resources and stores them in a Hashtable indicated in the Table property.

(Geerbt von ResourceSet)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator()

Gibt ein IEnumerator-Objekt zurück, um eine Racebedingung mit Dispose zu vermeiden.Returns an IEnumerator object to avoid a race condition with Dispose. Dieser Member ist nicht für die direkte Verwendung im Code vorgesehen.This member is not intended to be used directly from your code.

(Geerbt von ResourceSet)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Sicherheit

LinkDemand
für volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.for full trust for the immediate caller. Diese Klasse kann von teilweise vertrauenswürdigem Code nicht verwendet werden.This class cannot be used by partially trusted code.

InheritanceDemand
für volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.for full trust for the immediate caller. Diese Klasse kann von teilweise vertrauenswürdigem Code nicht geerbt werden.This class cannot be inherited by partially trusted code.

Gilt für:

Siehe auch