Share via


Position, propriété (ADO)

Indique la position actuelle dans un objet Stream.

Paramètres et valeurs de retour

Définit ou renvoie une valeur Long qui spécifie le décalage, en nombre d’octets, de la position actuelle à partir du début du flux. La valeur par défaut est 0, qui représente le premier octet du flux.

Notes

La position actuelle peut être déplacée vers un point après la fin du flux. Si vous spécifiez la position actuelle au-delà de la fin du flux, la taille de l’objet Stream est augmentée en conséquence. Les nouveaux octets ajoutés de cette façon seront null.

Notes

Position mesure toujours les octets. Pour les flux de texte utilisant des jeux de caractères multioctets, multipliez la position par la taille du caractère pour déterminer le nombre de caractères. Par exemple, pour un jeu de caractères à deux octets, le premier caractère est à la position 0, le deuxième caractère à la position 2, le troisième caractère à la position 4, et ainsi de suite.

Notes

Les valeurs négatives ne peuvent pas être utilisées pour modifier la position actuelle dans un flux. Seuls les nombres positifs peuvent être utilisés pour Position.

Notes

Pour les objets Stream en lecture seule, ADO ne renvoie pas d’erreur si Position est définie sur une valeur supérieure à la taille du flux. Cela ne modifie pas la taille du flux ou ne modifie pas le contenu du flux de quelque manière que ce soit. Toutefois, cette opération doit être évitée, car elle entraîne une valeur Positionsans signification.

S'applique à

Stream, objet (ADO)

Voir aussi

Charset, propriété (ADO)