Parameter-Objekt | (Versionen 2.0, 2.1, 2.5 und 2.6) |
Das Objekt Parameter enthält Informationen zu einer Variablen in einer SQL-Anweisung oder in gespeicherten Prozeduren. Zusammengenommen gehören Parameter-Objekte zur Kollektion Parameters der Command-Objekte. |
Parameter.AppendChunk-Methode | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameter.AppendChunk Data | |
Über die Methode AppendChunk werden Daten innerhalb des aktuellen Parameter-Objekts an ein großes Datenfeld oder ein binäres Feld angehängt. |
|
Argumente | |
|
|
Beschreibung | |
Über die Methode AppendChunk werden große Mengen von Text- oder Binärdaten an ein vorhandenes Parameter-Objekt angehängt. Dies kann sehr nützlich sein, wenn das aktuelle System bezüglich der für den auszuführenden Vorgang benötigten Speichergröße über begrenzten Systemspeicher verfügt. Mit der Methode AppendChunk können Sie die Daten dem Objekt Field in benutzerdefinierten Inkrementen hinzufügen. Das Bit adFldLong der Eigenschaft Arguments des Parameter-Objekts muss eingerichtet sein, damit die Methode AppendChunk des Objekts aufgerufen werden kann. Wenn Sie die Methode AppendChunk für ein Parameter-Objekt mehrmals aufrufen, hängen Sie die Daten jeweils an die bereits vorhandenen Daten im Objekt an. Sie können die Daten in einem Parameter-Objekt nur löschen, wenn Sie eine Stringlänge von Null festlegen. Wenn Sie der Methode AppendChunk eines Parameter-Objekts den Wert Null zuweisen, wird ein Fehler erzeugt. |
|
Siehe auch | |
Parameter.Arguments-Eigenschaft |
|
Parameter.Attributes-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameter.Attributes = ParameterAttributesEnum | |
Die Eigenschaft Attributes wird eingesetzt, um bestimmte Merkmale eines Parameter-Objekts festzulegen bzw. zurückzugeben. |
|
Datentyp | |
ParameterAttributesEnum (Long) |
|
Beschreibung | |
Für die Eigenschaft Arguments besteht Lese- und Schreibberechtigung. Der Wert der Eigenschaft Arguments kann auf eine beliebige Summe der in der Enumeration ParameterArgumentsEnum in Anhang E aufgeführten Werte gesetzt werden. Der Standardwert für die Eigenschaft Arguments ist adParamSigned. |
|
Siehe auch | |
ParameterAttributesEnum-Enumeration |
|
Parameter.Direction-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameter.Direction = ParameterDirectionEnum | |
Die Eigenschaft Direction gibt an, ob der aktuelle Parameter ein Eingabe- oder Ausgabeparameter bzw. sowohl Eingabe- als auch Ausgabeparameter oder ein Rückgabewert einer gespeicherten Prozedur ist. |
|
Datentyp | |
ParameterDirectionEnum (Long) |
|
Beschreibung | |
Für die Eigenschaft Direction besteht sowohl Lese- als auch Schreibberechtigung. Sie sollten der Kollektion Parameters die Parameter manuell hinzufügen, damit ADO nicht zusätzliche Anrufe zum Datenprovider tätigen muss, um diese Information selbst zu finden. In einigen Fällen müssen Sie die Eigenschaft Direction manuell angeben, da bestimmte Datenprovider möglicherweise nicht in der Lage sind, diese Information selbst festzustellen. Die Eigenschaft Direction kann auf einen Eintrag in der Enumeration ParameterDirectionEnum in Anhang E gesetzt werden. |
|
Hinweis | |
Nicht alle Provider können den Wert der Eigenschaft Direction feststellen, deshalb muss die Anwendung für Provider, die nicht über diese Funktion verfügen, den Wert der Eigenschaft Direction für Parameter-Objekte manuell einstellen, bevor sie verwendet wird. |
|
Siehe auch | |
ParameterDirectionEnum-Enumeration |
|
Parameter.Name-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameter.Name = Name | |
Die Eigenschaft Name gibt den Namen des aktuellen Parameter-Objekts an. |
|
Datentyp | |
String |
|
Beschreibung | |
Für die Eigenschaft Name besteht für das Parameter-Objekt sowohl Lese- als auch Schreibberechtigung. Sie können die Eigenschaft Name nur einstellen, wenn das Parameter-Objekt nicht bereits einer Kollektion Parameters angehängt ist. Die Eigenschaft Name weist dem zugeordneten Parameter-Objekt einen Namen zu oder ruft ein Parameter-Objekt aus der Kollektion Parameters ab. Innerhalb des Kollektionsobjekts Parameters müssen Namen nicht eindeutig sein. |
|
Parameter.NumericScale-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
numberscale = parameter.NumericScale | |
Die Eigenschaft NumericScale gibt den Maßstab der numerischen Werte im aktuellen Parameter-Objekt an. |
|
Datentyp | |
Byte |
|
Beschreibung | |
Für die Eigenschaft NumericScale besteht für das Parameter-Objekt sowohl Lese- als auch Schreibberechtigung. Es wird eingesetzt, um zu bestimmen, wie viele Byte rechts des Dezimaltrennzeichens für ein numerisches Parameter-Objekt verwendet werden. |
|
Parameter.Precision-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
precision = parameter.Precision | |
Die Eigenschaft Precision repräsentiert den Genauigkeitsgrad eines numerischen Werts in dem aktuellen Parameter-Objekt. |
|
Datentyp | |
Byte |
|
Beschreibung | |
Für die Eigenschaft Precision besteht für das Parameter-Objekt sowohl Lese- als auch Schreibberechtigung. Diese Eigenschaft gibt einen Wert in Byte zurück, der die Gesamtanzahl der für die Darstellung eines Werts für ein numerisches Parameter-Objekt verwendeten Ziffern angibt. |
|
Parameter.Properties-Kollektion | (Versionen 2.0, 2.1, 2.5 und 2.6) |
Set properties = parameter.Properties | |
Die Kollektion Properties gibt eine Kollektionsklasse Properties zurück, die die für das Parameter-Objekt und den aktuellen Datenprovider spezifischen Merkmale enthält. |
|
Datentyp | |
Eigenschaften (Kollektionsobjekt) |
|
Beschreibung | |
Die Kollektionsklasse Properties enthält eine Klasseninstanz Property für jede Eigenschaft, die spezifisch für das Parameter-Objekt und den Datenprovider ist. |
|
Parameter.Size-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameter.Size = size | |
Die Eigenschaft Size gibt die maximale Größe eines Werts des Parameter-Objekts zurück. |
|
Datentyp | |
Long |
|
Beschreibung | |
Die Eigenschaft Size gibt die maximale Größe eines Werts des Parameter-Objekts in Byte zurück. Für diese Eigenschaft besteht sowohl Lese- als auch Schreibberechtigung. Wenn der Datentyp eines Parameter-Objekts von variabler Länge ist, muss die Eigenschaft Size festgelegt werden, bevor das Objekt an die Kollektion Parameters angehängt wird. Andernfalls wird ein Fehler erzeugt. Wenn Sie den Datentyp eines Parameter-Objekts auf variable Länge ändern möchten, müssen Sie zuerst die Eigenschaft Size festlegen, damit kein Fehler erzeugt wird. Sie sollten die Eigenschaft Size des Parameter-Objekts auch festlegen, bevor Sie die Methode Execute des Befehlsobjekts aufrufen. Wenn Sie dies nicht beachten und ein Datentyp variabler Länge existiert, versucht ADO möglicherweise, den maximal benötigten Speicher zuzuweisen. Dadurch wird ein Fehler erzeugt. |
|
Parameter.Type-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameter.Type = DataTypeEnum | |
Die Eigenschaft Type bestimmt den Datentyp des aktuellen Objekts. |
|
Datentyp | |
ParameterTypeEnum (Long) |
|
Beschreibung | |
Für die Eigenschaft Type besteht für das Parameter-Objekt sowohl Lese- als auch Schreibberechtigung. Diese Eigenschaft gibt einen Wert in Byte zurück, der die Gesamtanzahl der für die Darstellung eines Werts für ein numerisches Parameter-Objekt verwendeten Ziffern angibt. |
|
Siehe auch | |
DataTypeEnum-Enumeration |
|
Parameter.Value-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameter.Value = value | |
Die Eigenschaft Value gibt den Wert an, der dem aktuellen Parameter-Objekt zugewiesen ist. |
|
Datentyp | |
Variante |
|
Beschreibung | |
Die Eigenschaft Value liest den Wert des zugeordneten Parameter-Objekts und legt ihn fest. Diese Eigenschaft unterstützt lange Binärdaten über ADO. ADO liest die Eigenschaft Value des Parameter-Objekts nur einmal. Wenn Sie einen Befehl ausführen, der einen Parameter mit einer leeren Eigenschaft Value enthält und dabei eine Datensatzgruppe erstellt wird, müssen Sie diese Datensatzgruppe schließen, bevor die Eigenschaft Value gelesen wird. |
|
Parameters-Kollektion | |
Set parameters = command.Parameters Set fields = recordset.Fields | |
Weitere Informationen und Beispiele zur Kollektion Parameters finden Sie unter "Parameter-Objekt". |
|
Objekte | |
|
|
Methoden | |
|
|
Eigenschaften | |
|
|
Parameters.Append-Methode | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameters.Append Object | |
Mit der Methode Append wird ein neues Parameter-Objekt an die aktuelle Kollektionsklasse Parameters angehängt. |
|
Argumente | |
|
|
Beschreibung | |
Die Methode Append der Kollektion Parameters informiert ADO über den Typ der Parameter, die in gespeicherten Prozeduren oder parametrisierten Abfragen enthalten sind. Dies ist aus folgenden Gründen nützlich: Erstens wird auf diese Weise die Zeit verkürzt, die für die Ausführung der Aufgaben einer gespeicherten Prozedur oder parametrisierten Abfrage benötigt wird, indem die Aufrufe des Datenproviders bezüglich dieser Informationen minimiert werden. Zweitens ist es von Vorteil, die Parameter bereits vorher - durch Hinzufügen zu der Kollektion Parameters - anzugeben, da nicht alle Datenprovider diese Informationen an ADO weitergeben. In diesem Fall (d. h., wenn Sie die Kollektion Parameters nicht manuell mit Daten füllen) ist es sehr wahrscheinlich, dass Sie die gespeicherten Prozeduren oder Abfragen überhaupt nicht verwenden können. Wir empfehlen (wie auch Microsoft), dass Sie die Parameter einer gespeicherten Prozedur oder parametrisierten Abfrage wenn möglich im Voraus angeben, da Sie sich nicht immer darauf verlassen können, dass diese Informationen für ADO verfügbar sind. (Dabei ist die Zeitverkürzung hier ein zusätzlicher Vorteil.) |
|
Siehe auch | |
Command.CreateParameter-Methode, Parameter.Size-Eigenschaft, Parameter.Type-Eigenschaft |
|
Parameters.Count-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
count = parameters.Count | |
Die Eigenschaft Count gibt an, wie viele Parameter-Objekte zu der zugeordneten Kollektion Parameters gehören. |
|
Datentyp | |
Long |
|
Beschreibung | |
Wenn der Wert der Eigenschaft Count "Null" ist, befinden sich keine Parameter-Objekte in der zugeordneten Kollektion Parameters. Die Parameter-Objekte, die zur zugeordneten Kollektion Parameters gehören, werden jedoch von 0 bis zum Wert der Eigenschaft Count minus Eins indiziert. |
|
Parameters.Delete-Methode | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameters.Delete Index | |
Die Methode Delete entfernt ein Parameter-Objekt aus der Kollektionsklasse Parameters. |
|
Argumente | |
|
|
Beschreibung | |
Die Methode Delete der Kollektionsklasse Parameters entfernt ein Parameter-Objekt aus der Kollektion. Durch Übergabe des Namens bzw. der Ordinalposition eines gültigen Parameter-Objekts in der Kollektion entfernt die Methode Delete das angegebene Parameter-Objekt aus der zugeordneten Kollektionsklasse Parameters. |
|
Siehe auch | |
Parameter.Name-Eigenschaft |
|
Parameters.Item-Eigenschaft | (Versionen 2.0, 2.1, 2.5 und 2.6) |
Set error = errors.Item(Index) Set error = errors (Index) | |
Die Eigenschaft Item greift auf ein bestimmtes Parameter-Objekt zu, das zur Kollektion Parameters gehört. |
|
Datentyp | |
Objekt |
|
Beschreibung | |
Der Platzhalter Index hat den Datentyp "Variante", der die Ordinalposition eines Parameter-Objekts innerhalb der Kollektion Parameters darstellt. Wenn die Kollektion das angeforderte Element nicht enthält, wird ein Fehler erzeugt. |
|
Hinweis | |
Einige Sprachen unterstützen die Eigenschaft Item nach der ersten Syntax nicht. Verwenden Sie für diese Sprachen die zweite Syntax (ohne Namen der Methode Item). |
|
Parameters.Refresh-Methode | (Versionen 2.0, 2.1, 2.5 und 2.6) |
parameters.Refresh | |
Die Methode Refresh der Kollektionsklasse Parameters aktualisiert die Kollektion mit den Parametern der aktuell gespeicherten Prozedur oder parametrisierten Abfrage, die mit dem Befehlsobjekt verbunden ist, zu dem die Kollektion gehört. |
|
Beschreibung | |
Die Methode Refresh aktualisiert die Kollektionsklasse Parameters mit den Parametern der dem Command-Objekt zugeordneten gespeicherten Prozedur oder parametrisierten Abfrage. Wenn Sie versuchen, vor dem Aufruf der Methode Refresh auf die Kollektionsklasse Parameters zuzugreifen, wird die Methode automatisch von ADO aufgerufen. |
|