ADO AppendChunk-Methode
Definition und Verwendung
AppendChunk wird verwendet, um Daten zu einem großen Text- oder Binärfeld oder zu einem Parameter-Objekt hinzuzufügen.
Hinweis: Verwenden Sie die AppendChunk-Methode der Field- oder Parameter-Objekte, um lange binäre oder Zeichen-Daten zu füllen. Bei begrenztem Systemspeicher können Sie mit AppendChunk Teile eines Long-Werts anstatt des gesamten Long-Werts verarbeiten.
Objekt | Beschreibung der AppendChunk-Methode |
---|---|
Parameter |
Wenn der Bit adFldLong im Attributes-Attribut des Parameter-Objekts auf True gesetzt ist, kann die AppendChunk-Methode für diesen Parameter verwendet werden. Der erste Aufruf von AppendChunk auf dem Parameter-Objekt schreibt Daten in den Parameter und überschreibt alle vorhandenen Daten. Nachfolgende AppendChunk-Aufrufe auf dem Parameter-Objekt fügen Daten zu den vorhandenen Parameterdaten hinzu. Ein AppendChunk-Aufruf mit einem Null-Wert ignoriert alle Parameterdaten. |
Field |
Wenn der Bit adFldLong im Attributes-Attribut des Field-Objekts auf True gesetzt ist, kann die AppendChunk-Methode für dieses Feld verwendet werden. Der erste Aufruf von AppendChunk auf dem Field-Objekt schreibt Daten in das Feld und überschreibt alle vorhandenen Daten. Nachfolgende AppendChunk-Aufrufe fügen Daten zu den vorhandenen Daten hinzu. Wenn Daten zu einem Feld hinzugefügt und andere Feldwerte im aktuellen Datensatz gesetzt oder gelesen werden sollen, betrachtet ADO dies als abgeschlossen, dass Daten zum ersten Feld hinzugefügt wurden. Wenn AppendChunk-Methode auf dem ersten Feld erneut aufgerufen wird, interpretiert ADO diesen Aufruf als neue AppendChunk-Operation und überschreibt vorhandene Daten. Der Zugriff auf Felder anderer Recordset-Objekte (nicht Kopien des ersten Recordset-Objekts) unterbricht die AppendChunk-Operation nicht. Wenn AppendChunk auf dem Field-Objekt aufgerufen wird und kein aktuelles Record vorhanden ist, wird ein Fehler aufgetreten. Hinweis: Der AppendChunk-Methoden hat auf dem Field-Objekt des Record-Objekts keine Wirkung. Er führt keine Aktionen aus und verursacht einen Laufzeitfehler. |
Syntax
objectname.AppendChunk data
Parameter | Beschreibung |
---|---|
data | Variant, enthält die Daten, die dem Objekt hinzugefügt werden sollen. |