Compartilhar via


Propriedade Position (ADO)

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 desde o início do fluxo. O padrão é 0, que representa o primeiro byte no fluxo.

Observações

A posição atual pode ser movida para um ponto após o final do fluxo. Se você especificar a posição atual além do final do fluxo, o tamanho do objeto Stream será aumentado adequadamente. Todos os novos bytes adicionados dessa forma serão nulos.

Nota

Posição sempre mede bytes. Para fluxos de texto que usam conjuntos de caracteres multibyte, multiplatafa 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 está na posição 0, o segundo caractere na posição 2, o terceiro caractere na posição 4 e assim por diante.

Nota

Valores negativos não podem ser usados para alterar a posição atual em um Stream. Somente números positivos podem ser usados para Posição.

Nota

Para objetos Stream somente leitura, o ADO não retornará um erro se de Posição for definido como um valor maior que o tamanho do do Stream. Isso não altera o tamanho do Streamou altera o conteúdo do Stream de forma alguma. No entanto, isso deve ser evitado porque resulta em um valor de posição sem sentido.

Aplica-se a

objeto stream (ADO)

Consulte Também

propriedade Charset (ADO)