ResourceReader.GetEnumerator Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een enumerator voor dit ResourceReader object.
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 IDictionaryEnumeratorRetouren
Een enumerator voor dit ResourceReader object.
Implementeringen
Uitzonderingen
De lezer is gesloten of verwijderd en kan niet worden geopend.
Voorbeelden
In het voorbeeld in deze sectie wordt het volgende .txt bestand met de naam gebruikt PatientForm.txt om de resources te definiëren die door een toepassing worden gebruikt.
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:"
U kunt het .txt-bestand compileren in een .resources-bestand door de volgende opdracht uit te geven:
resgen PatientForm.txt
In het volgende voorbeeld worden de resources opgesomd PatientForm.resources en worden de naam en waarde van elke resource weergegeven.
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:"
Opmerkingen
Normaal gesproken inventariseert u resources door de GetEnumerator methode aan te roepen en vervolgens herhaaldelijk de MoveNext methode op het geretourneerde IDictionaryEnumerator object aan te roepen totdat de methode wordt geretourneerd false. De resourcenaam is beschikbaar vanuit de IDictionaryEnumerator.Key eigenschap; de waarde van de IDictionaryEnumerator.Value eigenschap. In het voorbeeld ziet u hoe u op deze manier resources opsommen.
De implementatie van de IDictionaryEnumerator.Value eigenschap door de ResourceReader klasse kan de volgende uitzonderingen genereren:
-
De assembly met het type waartoe de gegevens behoren, kan niet worden gevonden.
-
De gegevens hebben niet de verwachte indeling.
-
Het type waartoe de gegevens behoren, kan niet worden gevonden.
U kunt de uitzondering afhandelen door de GetResourceData methode aan te roepen om informatie over het gegevenstype en de bytematrix op te halen die is toegewezen aan de benoemde resource. Zie de sectie Resources ophalen op naam met GetResourceData in het ResourceReader klasonderwerp voor meer informatie.
Important
De ResourceReader klasse bevat twee methoden waarmee opsommingen worden geretourneerd. De GetEnumerator methode retourneert een IDictionaryEnumerator interfaceobject en is de aanbevolen methode om aan te roepen bij het inventariseren van resources.
