ResourceReader.GetEnumerator 메서드

정의

ResourceReader 개체에 대한 열거자를 반환합니다.Returns an enumerator for this ResourceReader object.

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

반환

ResourceReader 개체에 대한 열거자입니다.An enumerator for this ResourceReader object.

구현

예외

판독기가 닫혔거나 삭제되었으므로 액세스할 수 없는 경우The reader has been closed or disposed, and cannot be accessed.

예제

이 섹션의 예제에서는 명명 된.txt 파일 PatientForm.txt 애플리케이션에서 사용 하는 리소스를 정의 합니다.The example in this section uses the following .txt file named PatientForm.txt to define the resources used by an application.

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

다음 명령을 실행 하 여.txt 파일을.resources 파일로 컴파일할 수 있습니다.You can compile the .txt file into a .resources file by issuing the following command:

resgen PatientForm.txtresgen PatientForm.txt

다음 예제에서는 리소스 열거 PatientForm.resources 이름 및 각 값을 표시 합니다.The following example enumerates the resources in PatientForm.resources and displays the name and value of each.

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

설명

호출 하 여 리소스를 열거 하는 일반적으로 GetEnumerator 메서드를 반복적으로 호출한 다음 합니다 MoveNext 메서드는 반환 된 IDictionaryEnumerator 메서드가 반환 될 때까지 개체 false합니다.Typically, you enumerate resources by calling the GetEnumerator method and then repeatedly calling the MoveNext method on the returned IDictionaryEnumerator object until the method returns false. 리소스 이름은에서 사용할 수는 IDictionaryEnumerator.Key 속성;에서 해당 값을 IDictionaryEnumerator.Value 속성입니다.The resource name is available from the IDictionaryEnumerator.Key property; its value from the IDictionaryEnumerator.Value property. 이 예제에서는 이러한 방식으로 리소스를 열거 하는 방법을 보여 줍니다.The example illustrates how to enumerate resources in this way.

구현의 IDictionaryEnumerator.Value 속성을 ResourceReader 클래스에는 다음 예외를 throw 할 수 있습니다.The implementation of the IDictionaryEnumerator.Value property by the ResourceReader class can throw the following exceptions:

  • FileNotFoundException

    데이터가 속한 형식을 포함 하는 어셈블리를 찾을 수 없습니다.The assembly that contains the type to which the data belongs cannot be found.

  • FormatException

    데이터 형식이 아닙니다.The data is not in the expected format.

  • TypeLoadException

    데이터가 속한 형식을 찾을 수 없습니다.The type to which the data belongs cannot be found.

호출 하 여 예외를 처리할 수는 GetResourceData 데이터 형식 및 명명된 된 리소스에 할당 된 바이트 배열에 대 한 정보를 검색할 메서드입니다.You can handle the exception by calling the GetResourceData method to retrieve information about the data type and the byte array assigned to the named resource. 자세한 내용은 "검색 리소스에서 이름을 사용 하 여 GetResourceData" 섹션을 참조 하세요.를 ResourceReader 클래스 항목입니다.For more information, see the "Retrieving Resources by Name with GetResourceData" section in the ResourceReader class topic.

중요

ResourceReader 클래스 열거자를 반환 하는 두 가지 메서드가 포함 됩니다.The ResourceReader class includes two methods that return enumerators. 합니다 GetEnumerator 메서드가 반환 되는 IDictionaryEnumerator 인터페이스 개체 및 리소스 열거 될 때 호출 하는 것이 좋습니다.The GetEnumerator method returns an IDictionaryEnumerator interface object and is the recommended method to call when enumerating resources.

적용 대상

추가 정보