Método Connection.CreateQueryDef (DAO)

Aplica-se ao: Access 2013, Office 2013

Crie um novo objeto QueryDef.

Sintaxe

expressão . CreateQueryDef(Name, SQLText)

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

Parâmetros

Nome	Necessária/opcional	Tipo de dados	Descrição
Name	Opcional	Variant	Um Variant (String subtype) que exclusivamente nomeia a nova QueryDef.
SQLText	Opcional	Variant	Um Variant (String subtype) que é uma instrução SQL definindo o QueryDef. Se você omitir esse argumento, será possível definir o QueryDef configurando sua propriedade SQL antes ou depois de acrescentá-lo a uma coleção.

Valor de retorno

QueryDef

Comentários

Em um espaço de trabalho do Microsoft Access, se você fornecer algo diferente de uma cadeia de caracteres de comprimento zero para o nome ao criar um QueryDef, o objeto QueryDef resultante será automaticamente acrescentado à coleção QueryDefs.

Se o objeto especificado por name já for um membro da coleção QueryDefs, ocorrerá um erro de tempo de execução. Você pode criar um QueryDef temporário usando uma cadeia de caracteres de comprimento zero para o argumento name quando executar o método CreateQueryDef. Também é possível realizar isso configurando a propriedade Name de um QueryDef recém-criado como uma cadeia de caracteres de comprimento zero (""). Objetos QueryDef temporários são úteis se você desejar usar repetidamente instruções SQL dinâmicas sem ter de criar novos objetos permanentes na coleção QueryDefs. Não é possível acrescentar um QueryDef temporário a qualquer coleção porque uma cadeia de caracteres de comprimento zero não é um nome válido para um objeto QueryDef permanente. Sempre é possível definir as propriedades Name e SQL do objeto QueryDef recém-criado e subsequentemente acrescentar o QueryDef à coleção QueryDefs.

Para executar a instrução SQL em um objeto QueryDef, use o método Execute ou OpenRecordset.

Usar um objeto QueryDef é a maneira preferencial de executar consultas passagem SQL com bancos de dados ODBC.

Para remover um objeto QueryDef de uma coleção QueryDefs em um banco de dados de mecanismo de banco de dados Microsoft Access, use o método Delete na coleção.