TextElementEnumerator.Current プロパティ
文字列内の現在のテキスト要素を取得します。
Public Overridable ReadOnly Property Current As Object Implements _ IEnumerator.Current
[C#]
public virtual object Current {get;}
[C++]
public: __property virtual Object* get_Current();
[JScript]
public function get Current() : Object;
プロパティ値
文字列内の現在のテキスト要素を格納しているオブジェクト。
実装
例外
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | 列挙子が、文字列の最初のテキスト要素の前、または最後のテキスト要素の後に位置しています。 |
解説
.NET Framework は、単一の文字として表示されるテキストの単位、つまり書記素としてテキスト要素を定義します。テキスト要素は、基本文字、サロゲート ペア、または組み合わせた文字シーケンスの場合があります。Unicode Standard は、サロゲート ペアを 2 つのコード単位から成る単一の抽象文字を表すコード化文字表現として定義します。ペアの最初の単位が上位サロゲート、2 番目の単位が下位サロゲートとなります。Unicode Standard は、組み合わせ文字シーケンスを 1 つの基本文字と 1 つ以上の組み合わせ文字の組み合わせとして定義します。サロゲート ペアは、基本文字または組み合わせた文字を表すことができます。サロゲート ペアおよび組み合わせ文字シーケンスの詳細については、http://www.unicode.org の「The Unicode Standard」を参照してください。
列挙子を作成した後や Reset を実行した後に、文字列の最初のテキスト要素に列挙子を進めるためには、 Current の値を読み取る前に MoveNext を呼び出す必要があります。それ以外の場合は、 Current は未定義です。
MoveNext への最後の呼び出しで、文字列の末尾を示す false が返された場合、 Current は例外もスローします。
Current は列挙子の位置を移動しません。そのため、 Current を連続して呼び出した場合、 MoveNext または Reset が呼び出されるまで同じオブジェクトが返されます。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
参照
TextElementEnumerator クラス | TextElementEnumerator メンバ | System.Globalization 名前空間 | GetTextElement | ElementIndex | MoveNext | Reset