Append-Methode (ADO)
Gilt für: Access 2013, Office 2013
Ein Objekt wird einer Auflistung angefügt. Bei einer Fields-Auflistung wird möglicherweise ein neues Field-Objekt erstellt, bevor es der Auflistung angefügt wird.
Syntax
-Sammlung.Append-Objekt
-Felder. Anfügen von Name, Type, DefinedSize, Attrib, FieldValue
Parameter
| Parameter | Beschreibung |
|---|---|
| collection | A collection object. |
| fields | Eine Fields -Auflistung. |
| Objekt | Eine Objektvariable, durch die das anzufügende Objekt dargestellt wird. |
| Name | Ein String-Wert, der den Namen des neuen Field-Objekts enthält und nicht mit dem Namen eines anderen Objekts in fields übereinstimmen darf. |
| Typ | Ein DataTypeEnum-Wert, dessen Standardwert adEmpty ist und durch den der Datentyp des neuen Felds angegeben wird. Die folgenden Datentypen werden von ADO nicht unterstützt und sollten beim Anfügen neuer Felder an ein Recordset nicht verwendet werden: adIDispatch, adIUnknown, adVariant. |
| DefinedSize | Optional. A Long value that represents the defined size, in characters or bytes, of the new field. Der Standardwert für diesen Parameter wird von Type abgeleitet. Fields with a DefinedSize greater than 255 bytes, and treated as variable length columns. (Die Standardeinstellung "DefinedSize " ist nicht angegeben.) |
| Attrib | Optional. Ein FieldAttributeEnum-Wert, dessen Standardwert adFldDefault ist und durch den Attribute für das neue Feld angegeben werden. Wenn dieser Wert nicht angegeben ist, enthält das Feld von Type abgeleitete Werte. |
| FieldValue | Optional. Ein Variant -Objekt, durch das der Wert für das neue Feld dargestellt wird. Wenn nichts angegeben ist, wird dem Feld ein Nullwert angefügt. |
Hinweise
Parameters-Auflistung
Sie müssen die Type-Eigenschaft eines Parameter-Objekts festlegen, bevor Sie es der Parameters -Auflistung anfügen. Wenn Sie einen Datentyp mit variabler Länge auswählen, müssen Sie auch die Size-Eigenschaft auf einen größeren Wert als Null festlegen.
Indem Sie Parameter selbst beschreiben, minimieren Sie Aufrufe an den Anbieter und verbessern folglich die Leistung beim Verwenden gespeicherter Prozeduren oder parametrisierter Abfragen. Sie müssen jedoch die Eigenschaften der zur aufzurufenden gespeicherten Prozedur oder parametrisierten Abfrage zugeordneten Parameter kennen.
Verwenden Sie die CreateParameter-Methode, um Parameter -Objekte mit den entsprechenden Eigenschafteneinstellungen zu erstellen, und verwenden Sie die Append -Methode, um diese 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 für einen Anbieter schreiben, von dem keine Parameterinformationen bereitgestellt werden, müssen Sie mit dieser Methode die Parameters -Auflistung manuell auffüllen, um überhaupt Parameter verwenden zu können.
Fields-Auflistung
Der FieldValue-Parameter ist nur gültig, wenn ein Field-Objekt einem Record-Objekt und nicht einem Recordset-Objekt hinzugefügt wird. Mit einem Record-Objekt können Sie gleichzeitig Felder anfügen und Werte bereitstellen. Bei einem Recordset -Objekt müssen Sie Felder erstellen, während das Recordset geschlossen ist, dann das Recordset öffnen und den Feldern Werte zuweisen.
Hinweis
Für neue Field-Objekte, die der Fields-Auflistung eines Record-Objekts angefügt wurden, muss die Value-Eigenschaft festgelegt werden, bevor andere Field-Eigenschaften angegeben werden können. Zuerst muss ein bestimmter Wert für die Value-Eigenschaft zugewiesen und die Update-Methode für die Fields-Auflistung aufgerufen werden. Dann kann auf weitere Eigenschaften, z. B. Type oder Attributes, zugegriffen werden.
Field-Objekte der folgenden Datentypen (DataTypeEnum) können nicht der Fields-Auflistung angefügt werden und verursachen das Auftreten eines Fehlers: adArray, adChapter, adEmpty, adPropVariant und adUserDefined. Außerdem werden die folgenden Datentypen von ADO nicht unterstützt: adIDispatch, adIUnknown und adIVariant. Für diese Typen tritt beim Anfügen kein Fehler auf, aber die Verwendung kann zu unvorhersehbaren Ergebnissen, wie z. B. Speicherverlusten, führen.
Recordset
Wenn Sie die CursorLocation-Eigenschaft nicht festlegen, bevor Sie die Append -Methode aufrufen, wird CursorLocation automatisch auf adUseClient (einen CursorLocationEnum-Wert) festgelegt, wenn die Open-Methode des Recordset-Objekts aufgerufen wird.
Ein Laufzeitfehler tritt auf, wenn die Append -Methode für die Fields -Auflistung eines geöffneten Recordsets oder für ein Recordset, für das die ActiveConnection-Eigenschaft festgelegt wurde, aufgerufen wird. Sie können nur Felder zu einem Recordset hinzufügen, das nicht geöffnet ist und noch nicht mit einer Datenquelle verbunden wurde. Dies ist normalerweise der Fall, wenn ein Recordset -Objekt mit der CreateRecordset-Methode erstellt oder einer Objektvariablen zugewiesen wird.
Aufzeichnen
Es tritt kein Laufzeitfehler auf, wenn die Append -Methode für die Fields -Auflistung eines geöffneten Record -Objekts aufgerufen wird. Das neue Feld wird der Fields -Auflistung des Record -Objekts hinzugefügt. Wenn das Record -Objekt von einem Recordset abgeleitet wurde, wird das neue Feld nicht in der Fields -Auflistung des Recordset -Objekts angezeigt.
Sie können ein nicht vorhandenes Feld erstellen und der Fields -Auflistung anfügen, indem Sie dem Feldobjekt einen Wert zuweisen, als sei es bereits in der Auflistung vorhanden. Durch die Zuweisung wird die automatische Erstellung und Anfügung des Field -Objekts ausgelöst, dann wird die Zuweisung abgeschlossen.
Rufen Sie nach dem Anfügen eines Field -Objekts an die Fields -Auflistung eines Record -Objekts die Update -Methode der Fields -Auflistung auf, um die Änderung zu speichern.