Objeto Stream (ADO)

  • Artigo

Representa um fluxo de dados binários ou texto.

Em hierarquias estruturadas em árvore, como um sistema de arquivos ou um sistema de email, um Record pode ter um fluxo binário padrão de bits associado a ele que apresenta o conteúdo do arquivo ou do email. Um objeto Stream pode ser usado para manipular campos ou registros que contêm esses fluxos de dados. Um objeto Stream pode ser obtido destas maneiras:

  • De uma URL que aponta para um objeto (normalmente um arquivo) que contém dados binários ou de texto. Esse objeto pode ser um documento simples, um objeto Record que representa um documento estruturado ou uma pasta.

  • Com a abertura do objeto Stream padrão associado a um objeto Record. Você pode obter o fluxo padrão associado a um objeto Record quando o Record é aberto, a fim de eliminar uma viagem de ida e volta apenas para abrir o fluxo.

  • Instanciando um objeto Stream. Esses objetos Stream podem ser usados a fim de armazenar dados para fins de seu aplicativo. Ao contrário de um Stream associado a uma URL ou ao Stream padrão de um Record, um Stream instanciado não tem associação com uma fonte subjacente por padrão.

Com os métodos e as propriedades de um objeto Stream, você pode fazer o seguinte:

  • Abra um objeto Stream de um Record ou URL com o método Open.

  • Feche um Stream com o método Close.

  • Bytes de entrada ou texto em um Stream com os métodos Write e WriteText.

  • Leia bytes do Stream com os métodos Read e ReadText.

  • Escreva todos os dados de Stream ainda no buffer do ADO no objeto subjacente com o método Flush.

  • Copie o conteúdo de um Stream para outro Stream com o método CopyTo.

  • Controle como as linhas são lidas do arquivo de origem com o método SkipLine e a propriedade LineSeparator.

  • Determine o fim da posição do fluxo com a propriedade EOS e o método SetEOS.

  • Salve e restaure dados em arquivos com os métodos SaveToFile e LoadFromFile .

  • Especifique o conjunto de caracteres usado para armazenar o Stream com a propriedade Charset.

  • Interrompa uma operação de Stream assíncrona com o método Cancel.

  • Determine o número de bytes em um Stream com a propriedade Size.

  • Controle a posição atual em um Stream com a propriedade Position.

  • Determine o tipo de dados em um Stream com a propriedade Type.

  • Determine o estado atual do Stream (fechado, aberto ou em execução) com a propriedade State.

  • Especifique o modo de acesso para o Stream com a propriedade Mode.

Observação

As URLs que usam o esquema HTTP invocarão automaticamente o Provedor Microsoft OLE DB para Publicação na Internet. Para obter mais informações, confira URLs absolutas e relativas.

O objeto Stream é seguro para scripts.

Esta seção contém os tópicos a seguir.

Confira também

Registros e fluxos