Append-Methode (ADO)
Fügt ein Objekt an eine Auflistung an. Wenn die Auflistung Fieldsist, kann ein neues Field-Objekt erstellt werden, bevor es an die Auflistung angefügt wird.
Syntax
collection.Append object
fields.Append Name, Type, DefinedSize, Attrib, FieldValue
Parameter
Sammlungs-
Ein Auflistungsobjekt.
Felder
Eine Fields-Auflistung.
Objekt-
Eine Objektvariable, die das anzufügende Objekt darstellt.
Name
Ein String- Wert, der den Namen des neuen Field-Objekts enthält und darf nicht denselben Namen wie jedes andere Objekt in Feldernsein.
Typ
Ein DataTypeEnum Wert, dessen Standardwert adEmpty-ist, der den Datentyp des neuen Felds angibt. Die folgenden Datentypen werden von ADO nicht unterstützt und sollten nicht verwendet werden, wenn neue Felder an ein Recordset Object (ADO)-angefügt werden: adIDispatch, adIUnknown, adVariant.
DefinedSize-
Wahlfrei. Ein Long-Wert, der die definierte Größe des neuen Felds in Zeichen oder Bytes darstellt. Der Standardwert für diesen Parameter wird von Typeabgeleitet. Felder mit einer DefinedSize größer als 255 Bytes werden als Spalten mit variabler Länge behandelt. Der Standardwert für DefinedSize- ist nicht angegeben.
Attrib-
Wahlfrei. Ein FieldAttributeEnum Wert, dessen Standardwert adFldDefaultist, der Attribute für das neue Feld angibt. Wenn dieser Wert nicht angegeben ist, enthält das Feld Attribute, die von Typeabgeleitet werden.
FieldValue-
Wahlfrei. Ein Variant-, der den Wert für das neue Feld darstellt. Wenn nicht angegeben, wird das Feld mit einem NULL-Wert angefügt.
Bemerkungen
Parameters-Auflistung
Sie müssen die Type-Eigenschaft eines Parameter--Objekts festlegen, bevor Sie es an die Parameters -Auflistung anfügen. Wenn Sie einen Datentyp mit variabler Länge auswählen, müssen Sie auch die eigenschaft Size auf einen Wert größer als 0 festlegen.
Durch die Beschreibung von Parametern selbst werden Aufrufe an den Anbieter minimiert und dadurch die Leistung verbessert, wenn Sie gespeicherte Prozeduren oder parametrisierte Abfragen verwenden. Sie müssen jedoch die Eigenschaften der Parameter kennen, die der gespeicherten Prozedur oder parametrisierten Abfrage zugeordnet sind, die Sie aufrufen möchten.
Verwenden Sie die CreateParameter Methode, um Parameter- Objekte mit den entsprechenden Eigenschafteneinstellungen zu erstellen, und verwenden Sie die Methode Append, um sie der Parameters-Auflistung hinzuzufügen. Auf diese Weise können Sie Parameterwerte festlegen und zurückgeben, ohne den Anbieter für die Parameterinformationen aufrufen zu müssen. Wenn Sie in einen Anbieter schreiben, der keine Parameterinformationen liefert, müssen Sie diese Methode verwenden, um die Parameters -Auflistung manuell aufzufüllen, um parameter überhaupt zu verwenden.
Fields-Auflistung
Der FieldValue--Parameter ist nur gültig, wenn ein Field-Objekt zu einem Record-Objekt hinzugefügt wird, nicht einem Recordset--Objekt. Mit einem Record-Objekt können Sie Felder anfügen und gleichzeitig Werte bereitstellen. Bei einem Recordset--Objekt müssen Sie Felder erstellen, während das Recordset- geschlossen ist, und öffnen Sie dann das Recordset- und weisen Sie den Feldern Werte zu.
Anmerkung
Bei neuen Field-Objekten, die an die Fields Auflistung eines Record-Objekts angefügt wurden, muss die eigenschaft Value festgelegt werden, bevor andere Field- Eigenschaften angegeben werden können. Zunächst muss ein bestimmter Wert für die eigenschaft Value zugewiesen sein und Update für die aufgerufene Fields-Auflistung. Anschließend können auf andere Eigenschaften wie Type oder Attributes zugegriffen werden. Field-Objekte der folgenden Datentypen (DataTypeEnum) können nicht an die Fields -Auflistung angefügt werden und führt zu einem Fehler: adArray, adChapter, adEmpty, adPropVariantund adUserDefined. Außerdem werden die folgenden Datentypen von ADO nicht unterstützt: adIDispatch, adIUnknownund adIVariant. Bei diesen Typen tritt beim Anfügen kein Fehler auf, die Verwendung kann jedoch zu unvorhersehbaren Ergebnissen führen, einschließlich Speicherlecks.
Recordset
Wenn Sie die eigenschaft CursorLocation vor dem Aufrufen der Methode Append nicht festlegen, wird CursorLocation- automatisch auf adUseClient- (ein CursorLocationEnum Wert) festgelegt, wenn die Open-Methode des Recordset-Objekts aufgerufen wird.
Ein Laufzeitfehler tritt auf, wenn die methode Append für die Fields Auflistung eines geöffneten Recordset-oder für ein Recordset- aufgerufen wird, in dem die ActiveConnection-Eigenschaft festgelegt wurde. Sie können Felder nur an eine Recordset- anfügen, die nicht geöffnet ist und noch nicht mit einer Datenquelle verbunden wurde. Dies ist in der Regel der Fall, wenn ein Recordset--Objekt mit der CreateRecordset--Methode erstellt oder einer Objektvariable zugewiesen wird.
Aufzeichnung
Ein Laufzeitfehler tritt nicht auf, wenn die methode Append für die Fields Collection eines geöffneten Recordaufgerufen wird. Das neue Feld wird der Fields Collection des Record-Objekts hinzugefügt. Wenn das Record von einem Recordset-abgeleitet wurde, wird das neue Feld nicht in der Fields Auflistung des Recordset-Objekts angezeigt.
Ein nicht vorhandenes Feld kann erstellt und an die Fields Auflistung angefügt werden, indem dem Feldobjekt ein Wert zugewiesen wird, als ob es in der Auflistung bereits vorhanden wäre. Die Zuordnung löst die automatische Erstellung und Das Anfügen des Field-Objekts aus, und dann wird die Zuordnung abgeschlossen.
Rufen Sie nach dem Anfügen eines Field an die Fields Collection eines Record-Objekts die Update-Methode der Fields-Auflistung auf, um die Änderung zu speichern.
Gilt für
Siehe auch
Append- und CreateParameter-Methode (Vb-Beispiel)
Append- und CreateParameter-Methode (Beispiel) (VC++)
CreateParameter-Methode (ADO)
Delete-Methode (ADO Fields-Auflistung)
Delete-Methode (ADO Parameters-Auflistung)
Delete-Methode (ADO Recordset)
Update-Methode