Position プロパティ (ADO)

Stream オブジェクト内の現在の位置を示します。

設定と戻り値

ストリーム先頭からの現在の位置のオフセット (バイト数) を指定する Long 値を設定または返します。 既定値は 0 で、ストリームの最初のバイトを表します。

注釈

現在の位置は、ストリーム末尾の後のポイントに移動できます。 現在の位置をストリームの末尾以降に指定すると、それに応じて Stream オブジェクトの Size が大きくなります。 この方法で追加された新しいバイトはすべて null になります。

注意

Position では常にバイトが測定されます。 マルチバイト文字セットを使用するテキスト ストリームの場合は、位置に文字サイズを掛けて文字数が決定されます。 たとえば、2 バイト文字セットの場合、最初の文字は 0 の位置、2 番目の文字は 2 の位置、3 番目の文字は 4 の位置、以降、同様に続きます。

注意

負の値を使用して、Stream 内の現在の位置を変更することはできません。 Position で使用できるのは、正の数値のみです。

注意

読み取り専用の Stream オブジェクトでは、Position が Stream の Size より大きい値に設定されている場合、ADO でエラーは返されません。 これにより、Stream のサイズが変更されたり、Stream のコンテンツが変更されたりすることはありません。 ただし、これを行うと、意味のない Position 値を得ることになるので避ける必要があります。

適用対象

Stream オブジェクト (ADO)

参照

Charset プロパティ (ADO)