TextElementEnumerator.Current プロパティ

.NET Framework クラス ライブラリ リファレンス

TextElementEnumerator.Current プロパティ

文字列内の現在のテキスト要素を取得します。

名前空間: System.Globalization
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Current As Object

Visual Basic (使用法)

Dim instance As TextElementEnumerator
Dim value As Object

value = instance.Current

C#

public Object Current { get; }

C++

public:
virtual property Object^ Current {
    Object^ get () sealed;
}

J#

/** @property */
public final Object get_Current ()

JScript

public final 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 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TextElementEnumerator クラス
TextElementEnumerator メンバ
System.Globalization 名前空間
GetTextElement
ElementIndex
MoveNext
Reset