Command-Objekt (ADO)

Gilt für: Access 2013, Office 2013

Definiert einen spezifischen Befehl, den Sie in einer Datenquelle ausführen wollen.

Hinweise

Mit einem Command -Objekt können Sie eine Datenbank abfragen und Datensätze in einem Recordset-Objekt zurückgeben, einen Massenvorgang ausführen oder die Struktur einer Datenbank ändern. Abhängig von der Funktionalität des Anbieters wird von einigen Command -Auflistungen, -Methoden oder -Eigenschaften möglicherweise ein Fehler erzeugt.

Die Auflistungen, Methoden und Eigenschaften eines Command -Objekts ermöglichen Folgendes:

• Festlegen des ausführbaren Texts des Befehls (z. B. eine SQL-Anweisung) mit der CommandText-Eigenschaft.

• Festlegen von parametrisierten Abfragen oder von Argumenten für gespeicherte Prozeduren mit Parameter-Objekten und der Parameters-Auflistung.

• Ausführen eines Befehls und Rückgabe eines Recordset -Objekts, falls zutreffend, mit der Execute-Methode.

• Festlegen des Befehlstyps mit der CommandType-Eigenschaft vor dem Ausführen des Befehls, um die Leistung zu optimieren.

• Steuern, ob der Anbieter vor dem Ausführen eine vorbereitete (oder kompilierte) Version des Befehls speichert, mit der Prepared-Eigenschaft.

• Festlegen, wie viele Sekunden ein Anbieter auf die Ausführung eines Befehls wartet, mithilfe der CommandTimeout-Eigenschaft.

• Zuordnen einer geöffneten Verbindung zu einem Command -Objekt, indem dessen ActiveConnection-Eigenschaft festgelegt wird.

• Festlegen der Name -Eigenschaft, um das Command -Objekt als Methode im zugeordneten Connection -Objekt zu identifizieren.

• Übergeben eines Command -Objekts an die Source-Eigenschaft eines Recordset -Objekts, um Daten abzurufen.

• Zugreifen auf anbieterspezifische Attribute für die Properties-Auflistung.

Hinweis

Um eine Abfrage ohne Verwendung eines Command-Objekts auszuführen, übergeben Sie eine Abfragezeichenfolge an die Execute-Methode eines Connection-Objekts oder an die Open-Methode eines Recordset-Objekts . However, a Command object is required when you want to persist the command text and re-execute it, or use query parameters.

Um ein Command-Objekt unabhängig von einem zuvor definierten Connection-Objekt zu erstellen, legen Sie dessen ActiveConnection-Eigenschaft auf einen gültigen Verbindungszeichenfolge fest. ADO erstellt weiterhin ein Connection-Objekt , weist dieses Objekt jedoch keiner Objektvariablen zu. Wenn Sie jedoch mehrere Command-Objekte derselben Verbindung zuordnen, sollten Sie explizit ein Connection-Objekt erstellen und öffnen. Dadurch wird das Connection-Objekt einer Objektvariablen zugewiesen. Wenn Sie die ActiveConnection-Eigenschaft des Command-Objekts nicht auf diese Objektvariable festlegen, erstellt ADO ein neues Connection-Objekt für jedes Command-Objekt, auch wenn Sie dieselbe Verbindungszeichenfolge verwenden.

Sie führen ein Command -Objekt aus, indem Sie es einfach mit seiner Name-Eigenschaft im zugeordneten Connection -Objekt aufrufen. Die ActiveConnection -Eigenschaft des Command -Objekts muss den Wert des Connection -Objekts haben. Wenn das Command -Objekt Parameter besitzt, übergeben Sie diese als Argumente an die Methode.

Wenn zwei oder mehrere Command -Objekte auf derselben Verbindung ausgeführt werden und eines der beiden Command - Objekte eine gespeicherte Prozedur ohne Parameter ist, tritt ein Fehler auf. Verwenden Sie unterschiedliche Verbindungen, oder trennen Sie alle anderen Command -Objekte von der Verbindung, um alle Command -Objekte auszuführen.

Die Parameters -Auflistung ist das Standardmitglied des Command -Objekts. Daher haben die beiden folgenden Codeanweisungen dieselbe Bedeutung.