ResXResourceReader-Klasse

Listet XML-Ressourcendateien (.resx) und -streams auf und liest die sequenziellen Paare von Ressourcennamen und -werten.

Namespace: System.Resources
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Class ResXResourceReader
    Implements IResourceReader, IEnumerable, IDisposable
'Usage
Dim instance As ResXResourceReader

public class ResXResourceReader : IResourceReader, IEnumerable, IDisposable

public ref class ResXResourceReader : IResourceReader, IEnumerable, IDisposable

public class ResXResourceReader implements IResourceReader, IEnumerable, 
    IDisposable

public class ResXResourceReader implements IResourceReader, IEnumerable, 
    IDisposable

Hinweise

ResXResourceReader stellt eine Standardimplementierung der IResourceReader-Schnittstelle bereit, die Ressourceninformationen im XML-Format liest. Verwenden Sie zum Lesen von Ressourceninformationen aus einem binären Ressourcenformat ResourceReader.

Mithilfe eines Ressourcenreader können Sie Paare von Ressourcennamen und -werten aus RESX-Dateien lesen. Die Ressourcen können aufgelistet werden, indem der von der GetEnumerator-Methode zurückgegebene IDictionaryEnumerator durchlaufen wird. Mit den vom IDictionaryEnumerator bereitgestellten Methoden können Sie zur jeweils nächsten Ressource wechseln und den Namen und Wert der einzelnen Ressourcen in der RESX-Datei lesen.

Weitere Informationen über das Format von RESX-Dateien finden Sie unter Ressourcen im RESX-Dateiformat.

Beispiel

Im folgenden Beispiel wird die Verwendung eines ResXResourceReader zum Durchlaufen der Ressourcen in einer RESX-Datei veranschaulicht. Zunächst wird der ResXResourceReaderrsxr für die Datei items.resx erstellt. Anschließend wird mit der GetEnumerator-Methode ein IDictionaryEnumerator erstellt, der die Ressourcen durchläuft und die Inhalte auf der Konsole anzeigt.

Imports System
Imports System.Resources
Imports System.Collections
Imports Microsoft.VisualBasic

Class ReadResXResources
   
   Public Shared Sub Main()
      
      ' Create a ResXResourceReader for the file items.resx.
      Dim rsxr As ResXResourceReader
      rsxr = New ResXResourceReader("items.resx")

      ' Create an IDictionaryEnumerator to iterate through the resources.
      Dim id As IDictionaryEnumerator = rsxr.GetEnumerator()
            
      ' Iterate through the resources and display the contents to the console.
      Dim d As DictionaryEntry
      For Each d In  rsxr
         Console.WriteLine(d.Key.ToString() + ":" + ControlChars.Tab + d.Value.ToString())
      Next d
      
      'Close the reader.
      rsxr.Close()

   End Sub

End Class

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

class ReadResXResources
{
   public static void Main()
   {
   
      // Create a ResXResourceReader for the file items.resx.
      ResXResourceReader rsxr = new ResXResourceReader("items.resx");

      // Create an IDictionaryEnumerator to iterate through the resources.
      IDictionaryEnumerator id = rsxr.GetEnumerator();       

      // Iterate through the resources and display the contents to the console.
      foreach (DictionaryEntry d in rsxr) 
      {
    Console.WriteLine(d.Key.ToString() + ":\t" + d.Value.ToString());
      }

     //Close the reader.
     rsxr.Close();
   }
}

#using <system.windows.forms.dll>
#using <System.dll>

using namespace System;
using namespace System::Resources;
using namespace System::Collections;
void main()
{
   
   // Create a ResXResourceReader for the file items.resx.
   ResXResourceReader^ rsxr = gcnew ResXResourceReader( "items.resx" );
   
   // Create an IDictionaryEnumerator* to iterate through the resources.
   IDictionaryEnumerator^ id = rsxr->GetEnumerator();
   
   // Iterate through the resources and display the contents to the console.
   IEnumerator^ myEnum = rsxr->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DictionaryEntry^ d = safe_cast<DictionaryEntry^>(myEnum->Current);
      Console::WriteLine( "{0}:\t {1}", d->Key, d->Value );
   }

   
   //Close the reader.
   rsxr->Close();
}

Vererbungshierarchie

System.Object
  System.Resources.ResXResourceReader

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ResXResourceReader-Member
System.Resources-Namespace

Weitere Ressourcen

Ressourcen im RESX-Dateiformat