Método TableDef.OpenRecordset (DAO)

Aplica-se ao: Access 2013, Office 2013

Cria um novo objeto Conjunto de registros e o acrescentar à coleção Conjuntos de registros.

Sintaxe

expressão . OpenRecordset(Tipo, Opções)

expressão Uma variável que representa um objeto TableDef.

Parâmetros

Nome	Necessária/opcional	Tipo de dados	Descrição
Name	Obrigatório	String	A origem dos registros para o novo Recordset. A origem pode ser um nome de tabela, um nome de consulta ou uma instrução SQL que retorna registros. Para objetos de Recordset do tipo tabela nos mecanismos de banco de dados do Microsoft Access, a origem pode ser apenas um nome de tabela.
Type	Opcional	Variant	Uma constante RecordsetTypeEnum que indica que tipo de Recordset abrir. OBSERVAÇÃO: Se você abrir um Conjunto de Registros em um espaço de trabalho do Microsoft Access e não especificar um tipo, o OpenRecordset criará uma tabela do tipo Conjunto de Registros, se possível. If you specify a linked table or query, OpenRecordset creates a dynaset-type Recordset.
Opções	Opcional	Variant	Uma combinação de constantes RecordsetOptionEnum que especifica as características do novo Recordset. OBSERVAÇÃO: As constantes dbConsistent e dbInconsistent são mutuamente exclusivas e usar ambas causará um erro. Fornecer um argumento lockedits quando opções usa a constante dbReadOnly também causará um erro.
LockEdit	Opcional	Variant	Uma constante LockTypeEnum que determina o bloqueio do Recordset. OBSERVAÇÃO: você pode usar a constante dbReadOnly tanto no argumento opções quanto no lockedits, mas não em ambos. Se você usá-la para ambos argumentos, ocorrerá um erro de tempo de execução.

Valor de retorno

Conjunto de Registros

Comentários

Normalmente, se o usuário obtém esse erro ao atualizar um registro, seu código deve atualizar o conteúdo dos campos e recuperar os valores modificados recentemente. Se o erro ocorrer ao excluir um registro, seu código poderá exibir os dados do novo registro para o usuário e uma mensagem indicando que os dados foram alterados recentemente. Nesse momento, seu código pode solicitar uma confirmação de que o usuário ainda deseja excluir o registro.

Você também deve usar a constante dbSeeChanges se for abrir um Recordset em um espaço de trabalho ODBC conectado ao mecanismo do banco de dados do Microsoft Access versus uma tabela do Microsoft SQL Server 6.0 (ou posterior) com uma coluna IDENTIDADE, caso contrário pode resultar em um erro.

Abrir mais de um Recordset em uma fonte de dados ODBC pode falhar porque a conexão está ocupada com uma chamada OpenRecordset anterior. Uma forma de contornar essa situação é preencher totalmente o Recordset usando o método MoveLast assim que o Recordset for aberto.

Fechar o Recordset com o método Close o exclui automaticamente da coleção de Recordsets.

Observação

Se a origem se referir a uma instrução SQL composta por uma cadeia de caracteres concatenada com um valor não inteiro, e os parâmetros do sistema especificar um não-eua. caractere decimal, como uma vírgula (por exemplo, strSQL = "PRICE > " & lngPrice e lngPrice = 125,50), ocorre um erro ao tentar abrir o Recordset. Isso se deve ao fato de que, durante a concatenação, o número é convertido em uma cadeia de caracteres usando o caractere decimal padrão do seu sistema, e o SQL aceita apenas caracteres decimais americanos.