Compartir a través de


Método Connection.CreateQueryDef (DAO)

Se aplica a: Access 2013, Office 2013

Crea un nuevo objeto QueryDef.

Sintaxis

expresión . CreateQueryDef(Name, SQLText)

expression Variable que representa un objeto Connection.

Parameters

Nombre

Obligatorio/opcional

Tipo de datos

Descripción

Name

Opcional

Variant

Variant (subtipo String) que designa inequívocamente el nuevo objeto QueryDef.

SQLText

Opcional

Variant

Variant (subtipo String) que es una instrucción SQL que define el objeto QueryDef. Si omite este argumento, puede definir el objeto QueryDef estableciendo su propiedad SQL antes o después de agregarlo a una colección.

Valor devuelto

QueryDef

Comentarios

En un área de trabajo de Microsoft Access, si proporciona cualquier otro elemento que no sea una cadena de longitud cero para el nombre al crear un objeto QueryDef, el objeto QueryDef resultante se agrega automáticamente a la colección QueryDefs.

Si el objeto especificado por el nombre ya es un miembro de la colección QueryDefs, se produce un error en tiempo de ejecución. Puede crear un archivo QueryDef temporal utilizando una cadena de longitud cero para el argumento de nombre cuando ejecuta el método CreateQueryDef. También puede realizar esto estableciendo la propiedad nombre de un QueryDef recién creado en una cadena de longitud cero (""). Los objetos QueryDef temporales son útiles si quiere utilizar instrucciones SQL repetidamente sin tener que crear nuevos objetos permanentes en la colección QueryDefs. No puede anexar un QueryDef temporal a cualquier colección ya que una cadena de longitud cero no es un nombre válido para un objeto QueryDef permanente. Siempre puede establecer las propiedades Name y SQL del objeto QueryDef recién creado y posteriormente anexar QueryDef a la colección QueryDefs.

Para ejecutar una instrucción SQL en un objeto QueryDef, use el método Execute u OpenRecordset.

El uso de un objeto QueryDef es el método recomendado para realizar consultas de paso a través SQL con bases de datos ODBC.

Para quitar un objeto QueryDef de una colección QueryDefs en una base de datos del motor de base de datos de Microsoft Access, utilice el método Delete en la colección.