Propriedade Position (ADO)

Aplica-se ao: Access 2013, Office 2013

Indica a posição atual em um objeto Stream.

Configurações e valores retornados

Define ou retorna um valor Long que especifica o deslocamento, em número de bytes, da posição atual a partir do início do fluxo. O padrão é 0, que representa o primeiro byte no fluxo.

Comentários

A posição atual pode ser movida para um ponto posterior ao final do fluxo. Se você especificar a posição atual além do final do fluxo, o Size do objeto Stream aumentará de forma adequada. Os bytes novos adicionados desta forma serão nulos.

Observação

[!OBSERVAçãO] Position sempre mede bytes. Para fluxos de texto que utilizam conjuntos de caracteres com vários bytes, multiplique a posição pelo tamanho do caractere para determinar o número do caractere. Por exemplo, para um conjunto de caracteres de dois bytes, o primeiro caractere estará na posição 0, o segundo caractere na posição 2, o terceiro na posição 4, e assim por diante.

Os valores negativos não podem ser utilizados para alterar a posição atual em um Stream. Somente números positivos podem ser utilizados para Position.

Para objetos Stream somente leitura, o ADO não retornará um erro se Position for definida com um valor superior ao Size do Stream. Isto não altera o tamanho do Stream nem do conteúdo do Stream. Entretanto, esse procedimento deve ser evitado, pois resulta em um valor Position insignificante.