Objeto Stream (ADO)
Representa um fluxo de dados binários ou texto.
Em hierarquias estruturadas por árvore, como um sistema de arquivos ou um sistema de email, um Registro pode ter um fluxo binário padrão de bits associados a ele que contém 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.
Ao abrir o objeto Stream padrão associado a um objeto de Registro. Você pode obter o fluxo padrão associado a um objeto Record quando o de Registro de for aberto, para eliminar uma viagem de ida e volta apenas para abrir o fluxo.
Criando uma instância de um objeto Stream. Esses objetos Stream podem ser usados para armazenar dados para fins de seu aplicativo. Ao contrário de um Stream associado a uma URL ou o de Fluxo de padrão de um de Registro de, uma de Fluxo de instanciada 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 de Registro ou URL com o método Open.
Feche um stream com o método Close.
Insira bytes ou texto em um de fluxo de com os métodos Write e WriteText.
Escreva qualquer stream dados ainda no buffer do ADO no objeto subjacente com o método de liberação de.
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 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 assíncrona Stream com o método Cancelar.
Determine o número de bytes em uma de fluxo de com a propriedade tamanho do.
Controlar 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 de Fluxo com a propriedade modo.
Nota
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, consulte URLs absolutas e relativas.
O objeto Stream é seguro para scripts.
Esta seção contém os tópicos a seguir.