Método Open (Stream do ADO)

Aplica-se ao: Access 2013, Office 2013

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

Sintaxe

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

Parâmetros

Parâmetro Descrição
Source Opcional. Um valor Variant que especifica a fonte dos dados para o Stream. A origem pode conter uma cadeia de URL absoluta que aponta para um nó existente numa estrutura de árvore bem conhecida, como um e-mail ou sistema de ficheiros. Um URL deve ser especificado com o URL palavra-chave ("URL=scheme://server/folder"). De forma alternativa, Source pode conter uma referência para um objeto Record já aberto, que abre o fluxo padrão associado ao Record. Se Source não for especificado, um Stream será instanciado e aberto, não associado a fonte base alguma por padrão. Para obter mais informações sobre os esquemas de URL e os respetivos fornecedores associados, veja URLs absolutos e relativos.
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 modos de acesso. Se Mode não for especificado, ele será herdado do 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ária, acessa o objeto Stream.
Password Opcional. Um valor String que contém a senha que, se necessária, acessa o objeto Stream.

Comentários

Quando um objeto Registo é transmitido como o parâmetro de origem, os parâmetros UserID e Password não são utilizados porque o acesso ao objeto Gravar já está disponível. Da mesma forma, o Modo do objeto Gravar é transferido para o objeto Stream. Quando a Origem não é especificada, o Stream aberto não contém dados e tem um Tamanho de zero (0). Para evitar perder quaisquer dados escritos neste Stream quando o Stream é fechado, guarde o Stream com os métodos CopyTo ou SaveToFile ou guarde-o noutra localização de memória.

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

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

Além das opções discutidas acima, por meio da não especificação de Source é possível simplesmente instanciar um objeto Stream em memória sem associá-lo a uma fonte base. Você pode adicionar dados dinamicamente ao fluxo simplesmente pela gravação de dados de texto ou binários no Stream com Write ou WriteText, ou pelo carregamento de dados a partir de um arquivo com LoadFromFile.

  • Last updated on