Report.InputParameters-Eigenschaft (Access)

Verwenden Sie die InputParameters-Eigenschaft , um die Eingabeparameter anzugeben oder zu bestimmen, die an eine SQL-Anweisung in der RecordSource-Eigenschaft eines Formulars oder Berichts oder einer gespeicherten Prozedur übergeben werden, wenn sie als Datensatzquelle in einem Microsoft Access-Projekt (.adp) verwendet werden. Zeichenfolge mit Lese-/Schreibzugriff.

Syntax

Ausdruck. Inputparameters

Ausdruck Eine Variable, die ein Report-Objekt darstellt.

HinwBemerkungeneise

Bei Verwendung mit einer RecordSource-Eigenschaft

Eine Zeichenfolge der InputParameters-Eigenschaft in Verbindung mit einer SQL-Anweisung in der RecordSource-Eigenschaft z. B. verwendet folgende Syntax:

state char=[Forms]![formname]![StateList], salesyear smallint=[Forms]![formname]![Enter year of interest]

Dies würde dazu führen, dass der state-Parameter auf den aktuellen Wert des StateList-Steuerelements festgelegt wird und der Benutzer zur Eingabe des salesyear-Parameters aufgefordert wird. Falls weitere Parameter existieren, die nicht in der Liste aufgeführt sind, werden ihnen die Standardwerte zugewiesen.

Die Abfrage sollte mit einem Marker für jeden nicht standardmäßigen Parameter in der Liste InputParameters ausgeführt werden.

Ein Aktualisierungs- oder Erneutabfragebefehl (über Menü, Tastatur oder Navigationsleiste) in Access sollte eine erneute Ausführung der Abfrage auslösen. Benutzer können dies im Code tun, indem sie die Standardmäßige Requery-Methode aufrufen. Falls der Wert eines Parameters an ein Steuerelement im Formular gebunden ist, wird bei der Abfragewiederholung der aktuelle Wert des Steuerelements verwendet. Die gespeicherte Prozedur wird nicht automatisch erneut ausgeführt, wenn der Wert des Steuerelements sich ändert.

Bei Verwendung mit einer gespeicherten Prozedur

Eine Beispielzeichenfolge der InputParameters-Eigenschaft , die mit einer gespeicherten Prozedur verwendet wird, würde die folgende Syntax verwenden.

@state char=[Forms]![formname]![StateList], @salesyear smallint=[Forms]![formname]![Enter year of interest]

Dies würde dazu führen, dass der @state Parameter auf den aktuellen Wert des StateList-Steuerelements festgelegt wird und der Benutzer zur Eingabe des @salesyear Parameters aufgefordert wird. Wenn die gespeicherte Prozedur andere Parameter enthält, die nicht in dieser Liste enthalten sind, werden ihnen Standardwerte zugewiesen.

Die gespeicherte Prozedur sollte mithilfe einer Befehlszeichenfolge ausgeführt werden, die die {call }-Syntax mit einem Marker für jeden nicht standardmäßigen Parameter in der Liste InputParameters enthält.

Ein Aktualisierungs- oder Erneutabfragebefehl (über Menü, Tastatur oder Navigationsleiste) in Access sollte eine erneute Ausführung der gespeicherten Prozedur auslösen. Benutzer können dies im Code tun, indem sie die Standardmäßige Requery-Methode aufrufen. Falls der Wert eines Parameters an ein Steuerelement im Formular gebunden ist, wird bei der Abfragewiederholung der aktuelle Wert des Steuerelements verwendet. Die gespeicherte Prozedur wird nicht automatisch erneut ausgeführt, wenn der Wert des Steuerelements sich ändert.

Dieser Editor-Dialog wird aufgerufen, wenn eine gespeicherte Prozedur erstmals als Datensatzquelle eines Formulars ausgewählt wird, falls die gespeicherte Prozedur Parameter besitzt. Nach der ursprünglichen Erstellung der InputParameters-Zeichenfolge wird derselbe Dialog als Editor zum Ändern der Zeichenfolge verwendet. In diesem Fall stammt die Liste der Parameter jedoch aus dem, was bereits in der Zeichenfolge vorhanden ist.

Parameterwerte können auch im Code mithilfe der ADO-Objekte ( Command ) und Parameter des ActiveX-Datenobjekts festgelegt werden. Wenn das Ergebnis ein Resultset zurückgibt, kann ein Formular daran gebunden werden, indem die Recordset-Eigenschaft des Formulars festgelegt wird. Die ADO-Codierung ist die einzige Möglichkeit, gespeicherte Prozeduren zu behandeln, die keine Resultsets zurückgeben, z. B. Aktionsabfragen, Ausgabeparameter zurückgeben, oder solche, die mehrere Resultsets zurückgeben.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.