Report. InputParameters-Eigenschaft (Access)Report.InputParameters property (Access)

Sie können die InputParameters -Eigenschaft verwenden, um die Eingabeparameter anzugeben oder zu bestimmen, die in der Daten Satz Herkunft -Eigenschaft eines Formulars oder Berichts oder einer gespeicherten Prozedur an eine SQL-Anweisung übergeben werden, wenn Sie in einer Microsoft Access- Projekt (ADP).You can use the InputParameters property to specify or determine the input parameters that are passed to a SQL statement in the RecordSource property of a form or report or a stored procedure when used as the record source within a Microsoft Access project (.adp). Zeichenfolge mit Lese-/Schreibzugriff.Read/write String.

SyntaxSyntax

Ausdruck. InputParametersexpression.InputParameters

Ausdruck Eine Variable, die ein Report -Objekt darstellt.expression A variable that represents a Report object.

BemerkungenRemarks

Bei Verwendung mit einer Eigenschaft "Quelle"When used with a RecordSource property

Eine Zeichenfolge der InputParameters-Eigenschaft in Verbindung mit einer SQL-Anweisung in der RecordSource-Eigenschaft z. B. verwendet folgende Syntax:An example InputParameters property string used with a SQL statement in the RecordSource property would use the following 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.This would result in the state parameter being set to the current value of the StateList control, and the user getting prompted for the salesyear parameter. Falls weitere Parameter existieren, die nicht in der Liste aufgeführt sind, werden ihnen die Standardwerte zugewiesen.If there were any other parameters that were not in this list, they would get default values assigned.

Die Abfrage sollte mit einer Markierung für jeden nicht-Standardparameter in der InputParameters -Liste ausgeführt werden.The query should be executed with one marker for each non-default parameter in the InputParameters list.

Ein Refresh-oder Requery-Befehl (über Menü, Tastatur oder Navigationsleiste) in Access sollte eine erneute Ausführung der Abfrage auslösen.A refresh or requery command (via menu, keyboard, or navigation bar) in Access should trigger a reexecute of the query. Benutzer können dies in Code ausführen, indem Sie die **** standardmäßige Requery-Methode aufrufen.Users can do this in code by calling the standard Requery method. Falls der Wert eines Parameters an ein Steuerelement im Formular gebunden ist, wird bei der Abfragewiederholung der aktuelle Wert des Steuerelements verwendet.If the value of a parameter is bound to a control on the form, the current value of the control is used at requery time. Die gespeicherte Prozedur wird nicht automatisch erneut ausgeführt, wenn der Wert des Steuerelements sich ändert.The query is not automatically reexecuted when the value of the control changes.

Bei Verwendung mit einer gespeicherten ProzedurWhen used with a stored procedure

Ein Beispiel für eine InputParameters -Eigenschaftszeichenfolge, die mit einer gespeicherten Prozedur verwendet wird, würde die folgende Syntax verwenden.An example InputParameters property string used with a stored procedure would use the following 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.This would result in the @state parameter being set to the current value of the StateList control, and the user getting prompted for the @salesyear parameter. Wenn es weitere Parameter für die gespeicherte Prozedur gäbe, die nicht in dieser Liste vorhanden waren, erhielten Sie Standardwerte.If there were any other parameters to the stored procedure that were not in this list, they would get default values assigned.

Die gespeicherte Prozedur sollte mithilfe einer Befehlszeichenfolge ausgeführt werden, die die {Call}-Syntax mit einer Markierung für jeden nicht-Standardparameter in der InputParameters -Liste enthält.The stored procedure should be executed by using a command string containing the {call } syntax with one marker for each non-default parameter in the InputParameters list.

Ein Refresh-oder Requery-Befehl (über Menü, Tastatur oder Navigationsleiste) in Access sollte eine erneute Ausführung der gespeicherten Prozedur auslösen.A refresh or requery command (via menu, keyboard, or navigation bar) in Access should trigger a reexecute of the stored procedure. Benutzer können dies in Code ausführen, indem Sie die **** standardmäßige Requery-Methode aufrufen.Users can do this in code by calling the standard Requery method. Falls der Wert eines Parameters an ein Steuerelement im Formular gebunden ist, wird bei der Abfragewiederholung der aktuelle Wert des Steuerelements verwendet.If the value of a parameter is bound to a control on the form, the current value of the control is used at requery time. Die gespeicherte Prozedur wird nicht automatisch erneut ausgeführt, wenn der Wert des Steuerelements sich ändert.The stored procedure is not automatically reexecuted when the value of the control changes.

Dieser Editor-Dialog wird aufgerufen, wenn eine gespeicherte Prozedur erstmals als Datensatzquelle eines Formulars ausgewählt wird, falls die gespeicherte Prozedur Parameter besitzt.This builder dialog is invoked when a stored procedure is first selected as the record source of a form if the stored procedure has any parameters. Nach der ursprünglichen Erstellung der InputParameters-Zeichenfolge wird derselbe Dialog als Editor zum Ändern der Zeichenfolge verwendet.After initial creation of the InputParameters string, this same dialog is used as a builder for changing the string. In diesem Fall stammt die Liste der Parameter jedoch von dem, was in der Zeichenfolge bereits vorhanden ist.In this case, however, the list of parameters comes from what already exists in the string.

Parameter Werte werden auch im Code mithilfe der Command -und Parameter -Objekte des ActiveX Data-Objekts festgelegt.Parameter values are also settable in code by using the ActiveX Data Object's (ADO) Command and Parameter objects. Wenn das Ergebnis ein Resultset zurückgibt, kann es durch Festlegen der Recordset -Eigenschaft des Formulars an dieses Formular gebunden werden.If the result returns a result set, a form can be bound to it by setting the form's Recordset property. ADO-Code ist der einzige Weg, um mit gespeicherten Prozeduren zu arbeiten, die keine Resultsets zurückgeben, wie beispielsweise Aktionsabfragen, die Ausgabeparameter zurückgeben, oder Aktionsabfragen, oder die mehrfache Resultsets zurückgeben.ADO coding is the only way to handle stored procedures that do not return result sets such as action queries, those that return output parameters, or those that return multiple result sets.

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.