ResourceReader.GetEnumerator Método

Definição

Namespace:

System.Resources

Assembly:

System.Runtime.dll

Origem:

ResourceReader.cs

Retorna um 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

Retornos

IDictionaryEnumerator

Um enumerador para este objeto ResourceReader .

Implementações

GetEnumerator()

Exceções

InvalidOperationException

O leitor foi fechado ou descartado e não pode ser acessado.

Exemplos

O exemplo nesta seção usa o seguinte arquivo .txt chamado PatientForm.txt para definir os recursos usados por um aplicativo.

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

Você pode compilar o arquivo .txt em um arquivo .resources emitindo o seguinte comando:

resgen PatientForm.txt

O exemplo a seguir enumera os recursos em PatientForm.resources e exibe o nome e o valor de cada um.

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

Comentários

Normalmente, você enumera recursos chamando o GetEnumerator método e chamando repetidamente o MoveNext método no objeto retornado IDictionaryEnumerator até que o método retorne false. O nome do recurso está disponível na IDictionaryEnumerator.Key propriedade ; seu valor da IDictionaryEnumerator.Value propriedade . O exemplo ilustra como enumerar recursos dessa maneira.

A implementação da IDictionaryEnumerator.Value propriedade pela ResourceReader classe pode gerar as seguintes exceções:

• FileNotFoundException

  O assembly que contém o tipo ao qual os dados pertencem não pode ser encontrado.

• FormatException

  Os dados não estão no formato esperado.

• TypeLoadException

  O tipo ao qual os dados pertencem não pode ser encontrado.

Você pode manipular a exceção chamando o GetResourceData método para recuperar informações sobre o tipo de dados e a matriz de bytes atribuída ao recurso nomeado. Para obter mais informações, consulte a seção "Recuperando recursos por nome com GetResourceData" no tópico de ResourceReader classe.

Importante

A ResourceReader classe inclui dois métodos que retornam enumeradores. O GetEnumerator método retorna um IDictionaryEnumerator objeto de interface e é o método recomendado para chamar ao enumerar recursos.

Confira também

• IDictionary
• IDictionaryEnumerator