Position プロパティ (ADO)Position Property (ADO)

内の現在位置を示す、 Streamオブジェクト。Indicates the current position within a Stream object.

設定と戻り値Settings and Return Values

設定または取得を長いストリームの先頭から現在の位置のバイト数でオフセットを指定する値。Sets or returns a Long value that specifies the offset, in number of bytes, of the current position from the beginning of the stream. 既定では 0 で、ストリーム内の最初のバイトを表します。The default is 0, which represents the first byte in the stream.

コメントRemarks

現在の位置は、ストリームの終了後、ポイントに移動できます。The current position can be moved to a point after the end of the stream. 現在のストリームの末尾を越える位置を指定する場合、サイズStreamオブジェクトがそれに応じて増加します。If you specify the current position beyond the end of the stream, the Size of the Stream object will be increased accordingly. この方法で追加された新しいバイトは、null になります。Any new bytes added in this way will be null.

注意

位置常にバイトを測定します。Position always measures bytes. テキスト ストリームはマルチバイト文字セットを使用して、位置の文字数を決定する、文字のサイズを乗算します。For text streams using multibyte character sets, multiply the position by the character size to determine the character number. たとえば、2 バイト文字セットでは、最初の文字は、位置 0、2、3 番目の文字の位置にある 2 番目の文字位置 4、具合が。For example, for a two-byte character set, the first character is at position 0, the second character at position 2, the third character at position 4, and so on.

注意

負の値を使用しての現在の位置を変更することはできません、 Streamします。Negative values cannot be used to change the current position in a Stream. 正の数値のみを使用できる位置します。Only positive numbers can be used for Position.

注意

読み取り専用Streamオブジェクトの場合は、ADO はエラーを返しません。位置より大きい値に設定されて、サイズの、 Streamします。For read-only Stream objects, ADO will not return an error if Position is set to a value greater than the Size of the Stream. サイズは変わりません、 Stream、alter、または、 Stream何らかの方法でコンテンツ。This does not change the size of the Stream, or alter the Stream contents in any way. ただし、これを行う避ける必要がありますので、意味のない位置値。However, doing this should be avoided because it results in a meaningless Positionvalue.

適用対象Applies To

Stream オブジェクト (ADO)Stream Object (ADO)

関連項目See Also

Charset プロパティ (ADO)Charset Property (ADO)