Compartilhar via


Método Open (Fluxo do ADO)

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

Sintaxe

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

Parâmetros

de origem
Opcional. Um valor Variant que especifica a fonte de dados do Stream. de origem pode conter uma cadeia de caracteres de URL absoluta que aponta para um nó existente em uma estrutura de árvore conhecida, como um sistema de arquivos ou email. Uma URL deve ser especificada usando a palavra-chave url ("URL= esquemaservidor/"). Como alternativa, de Origem pode conter uma referência a um objeto de Registro de já aberto, que abre o fluxo padrão associado ao de Registro de. Se de origem não for especificado, um de 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.

do modo
Opcional. Um valor ConnectModeEnum que especifica o modo de acesso para o de fluxo de resultante (por exemplo, leitura/gravação ou somente leitura). O valor padrão é adModeUnknown. Consulte a propriedade modo para obter mais informações sobre modos de acesso. Se Mode não for especificado, ele será herdado pelo objeto de origem. Por exemplo, se o registro de 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.

de senha
Opcional. Um valor de cadeia de caracteres que contém a senha que, se necessário, acessa o objeto Stream.

Observações

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

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

Embora o Stream não esteja 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 (além de verificar a de Estado e outras propriedades somente leitura) serão bloqueadas até que a operação Abrir seja concluída.

Além das opções discutidas anteriormente, não especificando de origem, 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 de Gravação 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)
do método Open (ADO Recordset)
método OpenSchema
Método SaveToFile