Freigeben über


Parameter-Objekt

Stellt einen Parameter oder ein Argument dar, das einem Command-Objekt, basierend auf einer parametrisierten Abfrage oder gespeicherten Prozedur, zugeordnet ist.

Bemerkungen

Viele Anbieter unterstützen parametrisierte Befehle. Dies sind Befehle, bei denen die gewünschte Aktion einmalig definiert wird, Variablen (oder Parameter) aber verwendet werden, um Details des Befehls zu ändern. Beispielsweise könnte eine SQL SELECT-Anweisung einen Parameter verwenden, um die übereinstimmenden Kriterien einer WHERE-Klausel zu definieren, sowie einen anderen Parameter, um den Spaltennamen für eine SORT BY-Klausel zu definieren.

Parameter-Objekte stellen Parameter dar, die parametrisierten Abfragen zugeordnet sind, oder die in-/out-Argumente und die Rückgabewerte gespeicherter Prozeduren. Je nach Funktionalität des Anbieters sind einige Auflistungen, Methoden oder Eigenschaften eines Parameter-Objekts möglicherweise nicht verfügbar.

Mit den Auflistungen, Methoden und Eigenschaften eines Parameter-Objekts können Sie Folgendes tun:

  • Festlegen oder Zurückgeben des Namens eines Parameters mit der Name-Eigenschaft.

  • Festlegen oder Zurückgeben des Werts eines Parameters mit der Value-Eigenschaft. Value ist die Standardeigenschaft des Parameter-Objekts.

  • Festlegen oder Zurückgeben von Parametermerkmalen mit den Eigenschaften Attribute, Direction, Precision, NumericScale, Size und Type.

  • Übergeben langer Binär- oder Zeichendaten an einen Parameter mit der AppendChunk-Methode.

  • Zugreifen auf anbieterspezifische Attribute mithilfe der Properties-Auflistung.

Wenn Sie die Namen und Eigenschaften der Parameter kennen, die der gespeicherten Prozedur oder der parametrisierten Abfrage zugeordnet sind, die Sie aufrufen möchten, können Sie die CreateParameter-Methode verwenden, um Parameter-Objekte mit den entsprechenden Eigenschafteneinstellungen zu erstellen, und die Append-Methode zum Hinzufügen der Parameters-Auflistung. Auf diese Weise können Sie Parameterwerte festlegen und zurückgeben, ohne die Refresh-Methode für die Parameters-Auflistung aufrufen zu müssen, um die Parameterinformationen vom Anbieter abzurufen, was ein potenziell ressourcenintensiver Vorgang ist.

Das Parameter-Objekt ist für die Skripterstellung nicht sicher.

Dieser Abschnitt enthält das folgende Thema.

Weitere Informationen

Command-Objekt (ADO)
CreateParameter-Methode (ADO)
Parameters-Collection (ADO)
Properties-Collection (ADO)