Método Open (Recordset do ADO)

Aplica-se ao: Access 2013, Office 2013

Abre um cursor.

Sintaxe

conjunto de registos. OpenSource, ActiveConnection, CursorType, LockType, Opções

Parâmetros

Os valores adExecuteNoRecords ou adExecuteStream de ExecuteOpenEnum não devem ser utilizados com Open.

Comentários

O cursor padrão para um Recordset do ADO é um cursor apenas leitura e apenas de avanço localizado no servidor.

A utilização do método Open em um objeto Recordset abre um cursor que representa registros de uma tabela base, os resultados de uma consulta ou um Recordset anteriormente salvo.

Utilize o argumento opcional Source para especificar uma fonte de dados que utiliza um dos seguintes itens: uma variável de objeto Command, uma instrução SQL, um procedimento armazenado, um nome de tabela, uma URL ou um nome de caminho de arquivo completo. Se Origem for um nome de caminho de ficheiro, pode ser um caminho completo ("c:\dir\file.rst"), um caminho relativo (".. \file.rst) ou um URL ("https://files/file.rst").

Não é uma boa ideia utilizar o argumento Source do método Open para executar uma consulta ação que não retorna registros porque não existe uma forma fácil de determinar se a chamada obteve êxito. O Recordset retornado por tal consulta será fechado. Chame o método Execute de um objeto Command ou o método Execute de um objeto Connection em vez de executar uma consulta que, tal como uma instrução SQL INSERT, não retorna registros.

O argumento ActiveConnection corresponde à propriedade ActiveConnection e especifica em qual conexão abrir o objeto Recordset. Se você passar uma definição de conexão para esse argumento, o ADO abrirá uma nova conexão utilizando os parâmetros especificados. Depois de abrir o Conjunto de registos com um cursor do lado do cliente (CursorLocation = adUseClient), pode alterar o valor desta propriedade para enviar atualizações para outro fornecedor. Ou ainda, poderá definir essa propriedade como Nothing (no Microsoft Visual Basic) ou NULL para desconectar o Recordset de qualquer provedor. No entanto, alterar ActiveConnection para um cursor do servidor gera um erro.

Para os demais argumentos que correspondem diretamente às propriedades de um objeto Recordset (Source, CursorType e LockType), a relação dos argumentos com as propriedades é a seguinte:

• A propriedade é de leitura/gravação antes do objeto Recordset ser aberto.
• As definições da propriedade são utilizadas, a menos que você passe os argumentos correspondentes ao executar o método Open. Se você passar um argumento, ele sobrescreverá a definição de propriedade correspondente, que será atualizada com o valor do argumento.
• Depois de abrir o objeto Recordset, essas propriedades serão somente leitura.

Se você passar um objeto Command no argumento Source e também passar um argumento ActiveConnection, ocorrerá um erro. A propriedade ActiveConnection do objeto Command já deve estar definida para um objeto Connection válido ou uma sequência de conexão.

Se você passar algo diferente de um objeto Command no argumento Source, poderá utilizar o argumento Options para otimizar a avaliação do argumento Source. Se o argumento Options não estiver definido, você poderá experimentar um desempenho diminuído porque o ADO deve fazer chamadas ao provedor para determinar se o argumento é uma instrução SQL, um procedimento armazenado, uma URL ou um nome de tabela. Se você souber qual tipo de Source está utilizando, a definição do argumento Options instrui o ADO a ir diretamente para o código relevante. Se o argumento Options não corresponder ao tipo de Source, ocorrerá um erro.

Se você passar um objeto Stream no argumento Source, não deverá passar informações para os demais argumentos. Fazer isso gerará um erro. As informações de ActiveConnection não são retidas quando um Recordset é aberto a partir de um Stream.

O padrão para o argumento Options é adCmdFile se nenhuma conexão estiver associada ao Recordset. Normalmente, esse será o caso para objetos Recordset armazenados persistentemente.

Se a fonte de dados não retornar registros, o provedor definirá as propriedades BOF e EOF para True e a posição do registro atual será indefinida. Ainda será possível adicionar novos dados a esse objeto Recordset vazio se o tipo do cursor assim o permitir.

Quando concluir as operações em um objeto Recordset aberto, utilize o método Close para liberar quaisquer recursos associados do sistema. O fechamento de um objeto não o remove da memória; é possível alterar as definições de propriedade e utilizar o método Open para abri-lo novamente mais tarde. Para eliminar completamente um objeto da memória, defina a variável do objeto como Nothing.

Antes que a propriedade ActiveConnection seja definida, chame Open sem operandos para criar uma instância de um Recordset criado por campos acrescentados à coleção Fields de Recordset.

Se você definiu a propriedade CursorLocation como adUseClient, poderá recuperar linhas assincronamente em uma das duas formas a seguir. O método recomendado é definir Options como adAsyncFetch. De modo alternativo, é possível utilizar a propriedade dinâmica "Asynchronous Rowset Processing" na coleção Properties, mas os eventos relacionados recuperados poderão ser perdidos se você não definir o parâmetro Options como adAsyncFetch.