DoCmd.SetParameter-Methode (Access)

Verwenden Sie die SetParameter-Methode , um einen Parameter für die Verwendung durch die Methoden BrowseTo, OpenForm, OpenQuery, OpenReport oder RunDataMacro zu erstellen.

Syntax

Ausdruck. SetParameter (Name, Ausdruck)

expression Eine Variable, die ein DoCmd-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Name Erforderlich Variant Der Name des Parameters. Der Name muss mit dem Namen des Parameters übereinstimmen, der von der BrowseTo-, OpenForm-, OpenQuery-, OpenReport- oder RunDataMacro-Methode erwartet wird.
Ausdruck Erforderlich Variant Ein Ausdruck, dessen Auswertung einen Wert ergibt, der dem Parameter zugewiesen werden soll.

HinwBemerkungeneise

Sie müssen so viele Aufrufe der SetParameter-Methode erstellen, wie Parameter erstellt werden sollen.

Jeder Aufruf von SetParameter fügt einen einzelnen Parameter in einer internen Parameterauflistung hinzu oder aktualisiert einen Parameter. Die Parameterauflistung wird an die BrowseTo-, OpenForm-, OpenQuery-, OpenReport- oder RunDataMacro-Methode übergeben. Wenn die Methode ausgeführt wird, stellt die Parameterauflistung die erforderlichen Parameter bereit. Wenn die Methode abgeschlossen ist, wird die Parameterauflistung gelöscht.

Da alle Methoden, die Parameter akzeptieren, den Inhalt der Parameterauflistung löschen, wenn die Methode beendet wird, muss sichergestellt sein, dass die Aufrufe von SetParameter unmittelbar vor dem Aufruf der Methode stehen, die die Parameter verwendet.

Beispiel

The following code example creates two parameters for use by the AddComment data macro. The two parameters are named prmComment and prmRelatedID, respectively. Der Wert des Textfelds txtComment wird im prmComment-Parameter gespeichert. Der Wert des Textfelds txtId wird im PrmRelatedID-Parameter gespeichert.

Private Sub cmdAddComment_Click() 
DoCmd.SetParameter "prmComment", Me.txtComment 
DoCmd.SetParameter "prmRelatedID", Me.txtId 
DoCmd.RunDataMacro "Comments.AddComment" 
End Sub

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.