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 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 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 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 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 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 modo do objeto Record é 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 os dados gravados neste Stream quando o Stream for fechado, salve o Stream com os métodos CopyTo ou SaveToFile ou salve-os em outro local 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.