Propiedad Position (ADO)

Indica la posición actual dentro de un objeto Stream.

Configuración y valores devueltos

Establece o devuelve un valor Long que especifica el desplazamiento, en número de bytes, de la posición actual desde el principio de la secuencia. El valor predeterminado es 0, que representa el primer byte de la secuencia.

Comentarios

La posición actual se puede mover a un punto después del final de la secuencia. Si especifica la posición actual más allá del final de la secuencia, la propiedad Size del objeto Stream aumentará en consecuencia. Los nuevos bytes agregados de esta forma serán null.

Nota

Position siempre mide bytes. En el caso de las secuencias de texto que usan juegos de caracteres multibyte, multiplique la posición por el tamaño de caracteres para determinar el número de caracteres. Por ejemplo, para un juego de caracteres de dos bytes, el primer carácter está en la posición 0, el segundo carácter en la posición 2, el tercer carácter en la posición 4, etc.

Nota

Los valores negativos no se pueden usar para cambiar la posición actual en un objeto Stream. Solo se pueden usar números positivos para Position.

Nota

En el caso de los objetos Stream de solo lectura, ADO no devolverá un error si Position está establecido en un valor mayor que la propiedad Size del objeto Stream. Esto no cambia el tamaño de Stream ni modifica el contenido de Stream de ninguna manera. Sin embargo, esto debe evitarse porque da como resultado un valor Position que carece de significado.

Se aplica a

Objeto de secuencia (ADO)

Consulte también

Propiedad de conjunto de caracteres (ADO)