ResourceReader.GetEnumerator Método

Definición

Espacio de nombres:

System.Resources

Ensamblado:

System.Runtime.dll

Source:

ResourceReader.cs

Devuelve un enumerador para este objeto ResourceReader.

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

Devoluciones

IDictionaryEnumerator

Enumerador de este objeto ResourceReader.

Implementaciones

GetEnumerator()

Excepciones

InvalidOperationException

El lector se ha cerrado o se ha eliminado y no se puede obtener acceso.

Ejemplos

En el ejemplo de esta sección se usa el siguiente archivo .txt denominado PatientForm.txt para definir los recursos usados por una aplicación.

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:"

Puede compilar el archivo .txt en un archivo .resources mediante la emisión del siguiente comando:

resgen PatientForm.txt

En el ejemplo siguiente se enumeran los recursos de PatientForm.resources y se muestra el nombre y el valor de cada uno.

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:"

Comentarios

Normalmente, se enumeran los recursos mediante una llamada al GetEnumerator método y, a continuación, se llama repetidamente al MoveNext método en el objeto devuelto IDictionaryEnumerator hasta que el método devuelve false. El nombre del recurso está disponible en la IDictionaryEnumerator.Key propiedad ; su valor de la IDictionaryEnumerator.Value propiedad . En el ejemplo se muestra cómo enumerar los recursos de esta manera.

La implementación de la IDictionaryEnumerator.Value propiedad por la ResourceReader clase puede producir las siguientes excepciones:

• FileNotFoundException

  Ensamblado que contiene el tipo al que pertenecen los datos.

• FormatException

  Los datos no están en el formato esperado.

• TypeLoadException

  Tipo al que pertenecen los datos.

Para controlar la excepción, llame al GetResourceData método para recuperar información sobre el tipo de datos y la matriz de bytes asignada al recurso con nombre. Para obtener más información, vea la sección "Recuperar recursos por nombre con GetResourceData" en el tema de la ResourceReader clase.

Importante

La ResourceReader clase incluye dos métodos que devuelven enumeradores. El GetEnumerator método devuelve un IDictionaryEnumerator objeto de interfaz y es el método recomendado al llamar al enumerar recursos.

Consulte también

• IDictionary
• IDictionaryEnumerator