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.

Comentários

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.

Observação

A Posição sempre mede bytes. Para fluxos de texto usando conjuntos de caracteres multibyte, multiplique a posição pelo tamanho do caractere para determinar o número de caracteres. Por exemplo, em 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.

Observação

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

Observação

Nos objetos Stream somente leitura, o ADO não retornará um erro se a Posição for definida como um valor maior que o Tamanho do Stream. Isso não altera o tamanho do Stream nem o conteúdo do Stream. No entanto, isso deve ser evitado porque resulta em um valor insignificante de Posição.

Aplica-se A

Objeto Stream (ADO)

Consulte Também

Propriedade Charset (ADO)