이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

TextElementEnumerator 클래스

 

게시 날짜: 2016년 11월

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

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

System.Object
  System.Globalization.TextElementEnumerator

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

이름설명
System_CAPS_pubpropertyCurrent

문자열의 현재 텍스트 요소를 가져옵니다.

System_CAPS_pubpropertyElementIndex

열거자가 현재 위치하고 있는 텍스트 요소의 인덱스를 가져옵니다.

이름설명
System_CAPS_pubmethodEquals(Object)

지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)

System_CAPS_protmethodFinalize()

개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)

System_CAPS_pubmethodGetHashCode()

기본 해시 함수로 작동합니다.(Object에서 상속됨)

System_CAPS_pubmethodGetTextElement()

문자열의 현재 텍스트 요소를 가져옵니다.

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨)

System_CAPS_protmethodMemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.(Object에서 상속됨)

System_CAPS_pubmethodMoveNext()

열거자를 문자열의 다음 텍스트 요소로 이동합니다.

System_CAPS_pubmethodReset()

문자열의 첫째 텍스트 요소 앞의 초기 위치에 열거자를 지정합니다.

System_CAPS_pubmethodToString()

현재 개체를 나타내는 문자열을 반환합니다.(Object에서 상속됨)

.NET Framework의 문자 소 즉, 단일 문자로 표시 되는 텍스트 단위로 텍스트 요소를 정의 합니다. 텍스트 요소는 다음 중 하나일 수 있습니다.

  • Single로 표현 되는 기본 문자, Char 값입니다. 예를 들어, 라틴어 대문자 문자는 (U + 0041) 및 LATIN SMALL LETTER AE (U + 00E6)는 기본 문자입니다.

  • 조합 문자는 기본 문자 및 하나 이상의 결합 문자 구성 된 시퀀스입니다. 예를 들어 예제 장 결합 하 여 뒤에 (U + 0041) LATIN CAPITAL LETTER (U + 0304)를 결합 하는 문자 시퀀스입니다.

  • 서로게이트 쌍을 하는 Unicode Standard 두 코드 단위의 시퀀스를 구성 하는 단일 추상 문자에 대 한 코드 문자 표현으로 정의: 상위 서로게이트 및 하위 서로게이트입니다. 서로게이트 쌍은 u t F-8로 인코딩된 문자로 유니코드 Basic Multilingual Plane 외부의 문자를 나타내기 위해 사용 됩니다. 예를 들어, 고딕 문자 SAUIL (U + 10343)는 utf-8 인코딩을 값이 0xd800 상위 서로게이트 및 하위 서로게이트 값이 인 0xDF43으로 표시 됩니다. 서로게이트 쌍은 기본 문자나 조합 문자를 나타낼 수 있습니다.

TextElementEnumerator 클래스를 사용 하면 단일 대신 문자열의 텍스트 요소를 사용 하 여 작업할 수 Char 개체입니다.

인스턴스화하는 TextElementEnumerator 에 문자열을 전달 하 여 특정 문자열을 나타내는 개체는 StringInfo.GetTextElementEnumerator 메서드. 이 문자열의 첫째 텍스트 요소 앞에 배치 되는 열거자를 반환 합니다. 호출 된 Reset 메서드도 실행 하면 열거자가이 위치로 복원 합니다. 호출 해야이 잘못 된 상태를 나타내므로 MoveNext 의 값을 읽기 전에 열거자를 문자열의 첫째 텍스트 요소를 이동 하는 Current 현재 텍스트 요소를 반환 하는 속성입니다.

작업을 할 때는 TextElementEnumerator 열거자의 위치를 지정 하는 일을 담당 하는 개체입니다. Current 속성 중 하나를 호출할 때까지 동일한 텍스트 요소를 반환 MoveNext 또는 Reset합니다. 열거자에 잘못 된 상태 이면 첫째 텍스트 요소 앞 이나 문자열의 마지막 텍스트 요소 뒤에 배치 됩니다. 열거자가 잘못 된 상태에서의 값을 검색 하는 Current 속성 예외를 throw 합니다. 테스트 하 여 열거자가 잘못 된 상태에 있는지 여부를 확인할 수 있는지 여부를의 반환 값은 MoveNext 속성은 false.

TextElementEnumerator 개체는 문자열 변수 또는 현재 리터럴 문자열의 현재 상태 스냅숏을 나타냅니다 하는 TextElementEnumerator 개체가 인스턴스화되면 합니다. 다음 사항에 유의합니다.

  • 텍스트 요소 열거자만 문자열에 데이터를 읽는 데 사용할 수 있습니다. 기본 문자열을 수정할 수는 없습니다.

  • 열거자는 것을 나타내는 문자열에 대 한 단독 액세스는 없습니다. 열거자가 만들어진 후에 문자열 변수를 수정할 수 있습니다.

  • A TextElementEnumerator 개체 시 문자열에 있는 텍스트 요소를 열거 하는 TextElementEnumerator 개체를 인스턴스화해야 합니다. 해당 변수가 나중에 수정 될 문자열 변수 이후의 변경 내용은 전혀 반영 되지 않습니다.

  • 때문에 TextElementEnumerator 클래스를 재정의 하지 않는 Object.Equals, 두 개의 TextElementEnumerator 동일한 문자열을 나타내는 개체를 다르게 간주 됩니다.

다음 예제에서는 TextElementEnumerator 문자열의 텍스트 요소를 열거 하는 클래스입니다.

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]:    Æ       Æ

*/

유니버설 Windows 플랫폼
8 이후 사용 가능
.NET Framework
1.1 이후 사용 가능
이식 가능한 클래스 라이브러리
이식 가능한 .NET 플랫폼 에서 지원됨
Silverlight
2.0 이후 사용 가능
Windows Phone Silverlight
7.0 이후 사용 가능
Windows Phone
8.1 이후 사용 가능

이 형식의 모든 public static(Visual Basic의 공유 Visual Basic의 경우) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전이 보장되지 않습니다.

맨 위로 이동
표시: