내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

TextElementEnumerator 클래스

문자열의 텍스트 요소를 열거합니다.

System.Object
  System.Globalization.TextElementEnumerator

네임스페이스:  System.Globalization
어셈블리:  mscorlib(mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class TextElementEnumerator : IEnumerator

TextElementEnumerator 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 속성XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Current문자열의 현재 텍스트 요소를 가져옵니다.
Public 속성XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ElementIndex열거자가 현재 위치하고 있는 텍스트 요소의 인덱스를 가져옵니다.
위쪽

  이름설명
Public 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Equals(Object) 지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)
Protected 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Finalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원GetHashCode기본 해시 함수로 작동합니다. (Object에서 상속됨)
Public 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원GetTextElement문자열의 현재 텍스트 요소를 가져옵니다.
Public 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Protected 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원MoveNext열거자를 문자열의 다음 텍스트 요소로 이동합니다.
Public 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Reset문자열의 첫째 텍스트 요소 앞의 초기 위치에 열거자를 지정합니다.
Public 메서드XNA Framework에서 지원이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
위쪽

.NET Framework는 텍스트 요소를 단일 문자(서기소)로 표시되는 텍스트 단위로 정의합니다. 텍스트 요소는 기본 문자, 서로게이트 쌍 또는 조합 문자 시퀀스가 될 수 있습니다. Unicode Standard에서는 두 개의 코드 단위 배열로 이루어진 단일 추상 문자에 대해 코딩된 문자 표시로써의 서로게이트 쌍에 대해 정의하며, 그 쌍에서 첫 번째 단위는 high surrogate 그리고 두 번째는 low surrogate입니다. 유니코드 표준은 하나의 기본 문자와 하나 이상의 결합 문자가 조합된 문자 시퀀스를 정의합니다. 서로게이트 쌍은 기본 문자나 조합 문자를 나타낼 수 있습니다.

텍스트 요소 열거자는 문자열의 데이터를 읽는 데만 사용되며, 내부 문자열을 수정하는 데는 사용할 수 없습니다.

열거자는 문자열에 단독으로 액세스할 수 없습니다.

열거자가 만들어질 때 문자열의 현재 상태 스냅숏이 만들어집니다. 같은 문자열에서 열거자 두 개를 동시에 만들어도 스냅숏은 서로 다를 수 있습니다.

열거자가 문자열의 첫째 텍스트 요소 앞이나 마지막 요소 뒤에 있으면 잘못된 상태입니다. 열거자가 잘못된 상태인 경우 Current를 호출하면 예외가 throw됩니다.

처음에는 열거자가 문자열의 첫 번째 요소 앞에 위치합니다. Reset 도 열거자를 이 위치에 다시 가져옵니다. 따라서 열거자를 만들거나 Reset을 호출한 후에는 MoveNext를 호출하여 열거자를 문자열의 첫째 텍스트 요소로 보낸 다음 Current 값을 읽어야 합니다.

Current MoveNext 또는 Reset가 호출될 때까지 같은 개체를 반환합니다.

문자열의 끝이 전달되면 열거자는 다시 잘못된 상태로 되고 MoveNext를 호출하면 false가 반환됩니다. MoveNext 를 마지막으로 호출하여 false가 반환된 경우 Current를 호출하면 예외가 throw됩니다.

다음 코드 예제에서는 특정 문자열의 텍스트 요소 열거와 관련하여 이 클래스를 사용하는 것에 대해 보여줍니다.


using System;
using System.Globalization;


public class SamplesTextElementEnumerator  {

   public static void Main()  {

      // Creates and initializes a String containing the following:
      //   - a surrogate pair (high surrogate U+D800 and low surrogate U+DC00)
      //   - a combining character sequence (the Latin small letter "a" followed by the combining grave accent)
      //   - a base character (the ligature "")
      String myString = "\uD800\uDC00\u0061\u0300\u00C6";

      // Creates and initializes a TextElementEnumerator for myString.
      TextElementEnumerator myTEE = StringInfo.GetTextElementEnumerator( myString );

      // Displays the values returned by ElementIndex, Current and GetTextElement.
      // Current and GetTextElement return a string containing the entire text element. 
      Console.WriteLine( "Index\tCurrent\tGetTextElement" );
      myTEE.Reset();
      while (myTEE.MoveNext())  {
         Console.WriteLine( "[{0}]:\t{1}\t{2}", myTEE.ElementIndex, myTEE.Current, myTEE.GetTextElement() );
      }

   }

}

/*
This code produces the following output.  The question marks take the place of high and low surrogates.

Index   Current GetTextElement
[0]:    ??      ??
[2]:    a`      a`
[4]:    Æ       Æ

*/


.NET Framework

4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

이식 가능한 클래스 라이브러리

이식 가능한 클래스 라이브러리에서 지원

Windows 스토어 앱용 .NET

Windows 8에서 지원

Windows Phone 앱용 .NET

Windows Phone 8, Silverlight 8.1에서 지원

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

커뮤니티 추가 항목

추가
표시:
© 2015 Microsoft