Método Open (Registro do ADO)

  • Artigo

Abre um objeto Record existente ou cria um novo item representado por Record, como um arquivo ou diretório.

Sintaxe

  
Open Source, ActiveConnection, Mode, CreateOptions, Options, UserName, Password

Parâmetros

Origem
Opcional. Uma Variant que pode representar a URL da entidade a ser representada por este objeto Record, um Comando, um Recordset aberto ou outro objeto Record, uma cadeia de caracteres que contém uma instrução SQL SELECT ou um nome de tabela.

ActiveConnection
Opcional. Uma Variant que representa a cadeia de caracteres de conexão ou o objeto Connection aberto.

Modo
Opcional. Um valor ConnectModeEnum que especifica o modo de acesso para o objeto Record resultante. O valor padrão é adModeUnknown.

CreateOptions
Opcional. Um valor RecordCreateOptionsEnum que especifica se um arquivo ou diretório existente deve ser aberto ou se um novo arquivo ou diretório deve ser criado. O valor padrão é adFailIfNotExists. Se definido como o valor padrão, o modo de acesso será obtido da propriedade Mode. Esse parâmetro é ignorado quando o parâmetro Source não contém uma URL.

Opções
Opcional. Um valor RecordOpenOptionsEnum que especifica opções para abrir o Record. O valor padrão é adOpenRecordUnspecified. Esses valores podem ser combinados.

UserName
Opcional. Um valor String que contém a ID do usuário que, se for necessário, autoriza o acesso à Source.

Senha
Opcional. Um valor String que contém a senha que, se for necessário, verifica UserName.

Comentários

Source pode ser:

  • Uma URL. Se o protocolo da URL for http, o Provedor de Internet será invocado por padrão. Se a URL apontar para um nó que contém um script executável (como uma página .ASP), um Record que contém a origem em vez do conteúdo executado será aberto por padrão. Use o argumento Options para modificar esse comportamento.

  • Um objeto Record. Um objeto Record aberto de outro Record clonará o objeto Record original.

  • Um objeto Command. O objeto Registro aberto representa a única linha retornada executando o Comando. Se os resultados contiverem mais de uma linha única, o conteúdo da primeira linha será colocado no registro e um erro poderá ser adicionado à coleção Errors.

  • Uma instrução SQL SELECT. O objeto Registro aberto representa a única linha retornada executando o conteúdo da cadeia de caracteres. Se os resultados contiverem mais de uma linha única, o conteúdo da primeira linha será colocado no registro e um erro poderá ser adicionado à coleção Errors.

  • Um nome de tabela.

Se o objeto Record representar uma entidade que não pode ser acessada com uma URL (por exemplo, uma linha de um Recordset derivado de um banco de dados), os valores da propriedade ParentURL e do campo acessado com a constante adRecordURL serão nulos.

Observação

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, confira URLs absolutas e relativas.

Aplica-se A

Objeto Record (ADO)

Consulte Também

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