ResourceReader.GetEnumerator Methode

Definition

Namespace:

System.Resources

Assembly:

System.Runtime.dll

Quelle:

ResourceReader.cs

Gibt einen Enumerator für dieses ResourceReader-Objekt zurück.

public:
 virtual System::Collections::IDictionaryEnumerator ^ GetEnumerator();

public System.Collections.IDictionaryEnumerator GetEnumerator ();

abstract member GetEnumerator : unit -> System.Collections.IDictionaryEnumerator
override this.GetEnumerator : unit -> System.Collections.IDictionaryEnumerator

Public Function GetEnumerator () As IDictionaryEnumerator

Gibt zurück

IDictionaryEnumerator

Ein Enumerator für dieses ResourceReader-Objekt.

Implementiert

GetEnumerator()

Ausnahmen

InvalidOperationException

Der Reader wurde geschlossen oder freigegeben, der Zugriff ist daher nicht möglich.

Beispiele

Im Beispiel in diesem Abschnitt wird die folgende .txt-Datei namens verwendet PatientForm.txt , um die von einer Anwendung verwendeten Ressourcen zu definieren.

Title="Top Pet Animal Clinic"
Label1="Patient Number:"
Label2="Pet Name:"
Label3="Species:"
Label4="Breed:"
Label5="Date of Birth:"
Label6="Age:"
Label7="Owner:"
Label8="Address:"
Label9="Home Phone:"
Label10="Work Phone:"
Label11="Mobile Phone:"

Sie können die .txt-Datei in eine RESOURCES-Datei kompilieren, indem Sie den folgenden Befehl ausgeben:

PatientForm.txtneu generieren

Das folgende Beispiel listet die Ressourcen in PatientForm.resources auf und zeigt den Namen und den Wert der einzelnen Ressourcen an.

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

public class Example
{
   public static void Main()
   {
      var rr = new ResourceReader("PatientForm.resources");
      IDictionaryEnumerator dict = rr.GetEnumerator();
      int ctr = 0;

      while (dict.MoveNext()) {
         ctr++;
         Console.WriteLine("{0:00}: {1} = {2}", ctr, dict.Key, dict.Value);
      }

      rr.Close();
   }
}
// The example displays the following output:
//       01: Label3 = "Species:"
//       02: Label2 = "Pet Name:"
//       03: Label1 = "Patient Number:"
//       04: Label7 = "Owner:"
//       05: Label6 = "Age:"
//       06: Label5 = "Date of Birth:"
//       07: Label4 = "Breed:"
//       08: Label9 = "Home Phone:"
//       09: Label8 = "Address:"
//       10: Title = "Top Pet Animal Clinic"
//       11: Label10 = "Work Phone:"
//       12: Label11 = "Mobile Phone:"

Imports System.Collections
Imports System.Resources

Module Example
   Public Sub Main()
      Dim rr As New ResourceReader("PatientForm.resources")
      Dim dict As IDictionaryEnumerator = rr.GetEnumerator
      Dim ctr As Integer

      Do While dict.MoveNext()
         ctr += 1
         Console.WriteLine("{0:00}: {1} = {2}", ctr, dict.Key, dict.Value)
      Loop
      
      rr.Close()
   End Sub
End Module
' The example displays the following output:
'       01: Label3 = "Species:"
'       02: Label2 = "Pet Name:"
'       03: Label1 = "Patient Number:"
'       04: Label7 = "Owner:"
'       05: Label6 = "Age:"
'       06: Label5 = "Date of Birth:"
'       07: Label4 = "Breed:"
'       08: Label9 = "Home Phone:"
'       09: Label8 = "Address:"
'       10: Title = "Top Pet Animal Clinic"
'       11: Label10 = "Work Phone:"
'       12: Label11 = "Mobile Phone:"

Hinweise

In der Regel listen Sie Ressourcen auf, indem Sie die GetEnumerator -Methode aufrufen und dann wiederholt die MoveNext -Methode für das zurückgegebene IDictionaryEnumerator Objekt aufrufen, bis die -Methode zurückgibt false. Der Ressourcenname ist über die IDictionaryEnumerator.Key -Eigenschaft verfügbar, sein Wert aus der IDictionaryEnumerator.Value -Eigenschaft. Das Beispiel veranschaulicht, wie Ressourcen auf diese Weise aufgelistet werden.

Die Implementierung der IDictionaryEnumerator.Value -Eigenschaft durch die ResourceReader -Klasse kann die folgenden Ausnahmen auslösen:

• FileNotFoundException

  Die Assembly, die den Typ enthält, zu dem die Daten gehören, kann nicht gefunden werden.

• FormatException

  Die Daten haben nicht das erwartete Format.

• TypeLoadException

  Der Typ, zu dem die Daten gehören, kann nicht gefunden werden.

Sie können die Ausnahme behandeln, indem Sie die GetResourceData -Methode aufrufen, um Informationen zum Datentyp und zum Bytearray abzurufen, das der benannten Ressource zugewiesen ist. Weitere Informationen finden Sie im Abschnitt "Abrufen von Ressourcen nach Name mit GetResourceData" im ResourceReader Klassenthema.

Wichtig

Die ResourceReader -Klasse enthält zwei Methoden, die Enumeratoren zurückgeben. Die GetEnumerator -Methode gibt ein IDictionaryEnumerator Schnittstellenobjekt zurück und ist die empfohlene Methode, die beim Aufzählen von Ressourcen aufgerufen werden soll.

Weitere Informationen

• IDictionary
• IDictionaryEnumerator