Connection.CreateQueryDef-Methode (DAO)

Gilt für: Access 2013, Office 2013

Erstellt ein neues QueryDef-Objekt.

Syntax

Ausdruck . CreateQueryDef(Name, SQLText)

Ausdruck Eine Variable, die ein Connection -Objekt darstellt.

Parameter

Name	Erforderlich/optional	Datentyp	Beschreibung
Name	Optional	Variant	Eine Variant (Untertyp String), die die neue QueryDef eindeutig benennt.
SQLText	Optional	Variant	Eine Variant (Untertyp String), bei der es sich um eine SQL-Anweisung handelt, die die QueryDef definiert. Wenn dieses Argument ausgelassen wird, können Sie die QueryDef durch Festlegen ihrer SQL -Eigenschaft definieren, bevor oder nachdem Sie sie an eine Auflistung anfügen.

Rückgabewert

QueryDef

Bemerkungen

Wenn Sie in einem Microsoft Access-Arbeitsbereich bei der Erstellung einer QueryDef einen anderen Wert als eine Zeichenfolge der Länge 0 (null) für den Namen angeben, wird das resultierende QueryDef-Objekt automatisch an die QueryDefs-Auflistung angefügt.

Wenn das von name angegebene Objekt bereits ein Mitglied der QueryDefs-Auflistung ist, tritt ein Laufzeitfehler auf. Sie können eine temporäre QueryDef erstellen, indem Sie beim Ausführen der CreateQueryDef-Methode eine Zeichenfolge der Länge 0 (null) für das name-Argument verwenden. Ein andere Methode besteht darin, die Name -Eigenschaft einer neu erstellten QueryDef auf eine Zeichenfolge der Länge 0 ("") festzulegen. Temporäre QueryDef -Objekte sind nützlich, wenn Sie dynamische SQL-Anweisungen wiederholt verwenden möchten, ohne neue dauerhafte Objekte in der QueryDefs -Auflistung zu erstellen. Sie können eine temporäre QueryDef nicht an eine Auflistung anfügen, da eine Zeichenfolge der Länge 0 (null) kein gültiger Name für ein dauerhaftes QueryDef -Objekt ist. Sie können immer die Eigenschaften Name und SQL des neu erstellten QueryDef -Objekts festlegen und die QueryDef anschließend an die QueryDefs -Auflistung anfügen.

Zum Ausführen der SQL-Anweisung in einem QueryDef-Objekt verwenden Sie die Execute- oder die OpenRecordset-Methode.

Die Verwendung eines QueryDef-Objekts ist das bevorzugte Verfahren zum Ausführen von SQL-Pass-Through-Abfragen mit ODBC-Datenbanken.

Um ein QueryDef-Objekt aus einer QueryDefs-Auflistung in einer Datenbank des Microsoft Access-Datenbankmoduls zu entfernen, führen Sie die Delete-Methode für die Auflistung aus.