Partilhar via


Método Open (Fluxo do ADO)

Abre um objeto Stream para processar fluxos de dados binários ou de texto.

Sintaxe

  
Stream.Open Source, Mode , OpenOptions, UserName, Password  

Parâmetros

Origem
Opcional. Um valor Variant que especifica a fonte de dados para o Stream. Origem pode conter uma cadeia de caracteres de URL absoluta que aponta para um nó existente em uma estrutura de árvore bem conhecida, como um sistema de arquivos ou email. Uma URL deve ser especificada usando a palavra-chave de URL ("URL=scheme://server/folder"). Como alternativa, a Origem pode conter uma referência a um objeto Record já aberto, que abre o fluxo padrão associado ao Record. Se a Origem não for especificada, um Fluxo será instanciado e aberto, associado a nenhuma fonte subjacente por padrão. Para obter mais informações sobre esquemas de URL e seus provedores associados, consulte URLs absolutas e relativas.

Modo
Opcional. Um valor ConnectModeEnum que especifica o modo de acesso para o Stream resultante (por exemplo, leitura/gravação ou somente leitura). O valor padrão é adModeUnknown. Consulte a propriedade Mode para obter mais informações sobre os modos de acesso. Se Mode não for especificado, ele será herdado pelo objeto de origem. Por exemplo, se o Record de origem for aberto no modo somente leitura, o Stream também será aberto no modo somente leitura por padrão.

OpenOptions
Opcional. Um valor StreamOpenOptionsEnum. O valor padrão é adOpenStreamUnspecified.

UserName
Opcional. Um valor String que contém a identificação do usuário que, se necessário, acessa o objeto Stream.

Senha
Opcional. Um valor String que contém a senha que, se necessário, acessa o objeto Stream.

Comentários

Quando um objeto Record é passado como o parâmetro de origem, os parâmetros UserID e Password não são usados porque o acesso ao objeto Record já está disponível. Da mesma forma, o objeto Mode of the Record é transferido para o objeto Stream. Quando Source não é especificado, o Stream aberto não contém dados e tem um Size de zero (0). Para evitar a perda de dados gravados neste Stream quando o Stream for fechado, salve o Stream com CopyTo ou métodos SaveToFile ou salve-o em outro local de memória.

Um valor OpenOptions de adOpenStreamFromRecord identifica o conteúdo do parâmetro Source como um objeto Record já aberto. O comportamento padrão é tratar Source como uma URL que aponta diretamente para um nó em uma estrutura de árvore. O fluxo padrão associado a esse nó é aberto.

Enquanto o Stream não estiver aberto, é possível ler todas as propriedades somente leitura do Stream. Se um Stream for aberto de forma assíncrona, todas as operações subsequentes (exceto verificar o State e outras propriedades somente leitura) serão bloqueadas até que a operação Open seja concluída.

Além das opções discutidas anteriormente, ao não especificar Source, você pode criar uma instância de um objeto Stream na memória sem associá-lo a uma fonte subjacente. Você pode adicionar dados dinamicamente ao fluxo gravando dados binários ou de texto no Stream com Write ou WriteText ou carregando dados de um arquivo com LoadFromFile.

Aplica-se A

Objeto Stream (ADO)

Consulte Também

Método Open (conexão ADO)
Método Open (Registro do ADO)
Método Open (Conjunto de registros ADO)
Método OpenSchema
Método SaveToFile