ResourceReader.GetEnumerator Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt einen Enumerator für dieses ResourceReader-Objekt zurück.
public:
virtual System::Collections::IDictionaryEnumerator ^ GetEnumerator();public:
System::Collections::IDictionaryEnumerator ^ GetEnumerator();public System.Collections.IDictionaryEnumerator GetEnumerator ();abstract member GetEnumerator : unit -> System.Collections.IDictionaryEnumerator
override this.GetEnumerator : unit -> System.Collections.IDictionaryEnumeratormember this.GetEnumerator : unit -> System.Collections.IDictionaryEnumeratorPublic Function GetEnumerator () As IDictionaryEnumeratorGibt zurück
Ein Enumerator für dieses ResourceReader-Objekt.
Implementiert
Ausnahmen
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:
-
Die Assembly, die den Typ enthält, zu dem die Daten gehören, kann nicht gefunden werden.
-
Die Daten haben nicht das erwartete Format.
-
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.
