Freigeben über


AppendChunk-Methode (ADO)

Fügt Daten an ein großes Text- oder Binärdaten-Field-oder an ein Parameter -Objekt an.

Syntax

  
object.AppendChunk Data  

Parameter

Objekt-
Ein Field- oder Parameter--Objekt.

Daten
Ein Variant-, das die an das Objekt anzufügenden Daten enthält.

Bemerkungen

Verwenden Sie die AppendChunk Methode für ein Field oder Parameter Objekt, um es mit langen Binär- oder Zeichendaten auszufüllen. In Situationen, in denen der Systemspeicher begrenzt ist, können Sie die AppendChunk- Methode verwenden, um lange Werte in Teilen zu bearbeiten und nicht vollständig.

Feld

Wenn das adFldLong Bit in der eigenschaft Attributes eines Field-Objekts auf truefestgelegt ist, können Sie die AppendChunk--Methode für dieses Feld verwenden.

Der erste AppendChunk-Aufruf für ein Field-Objekt schreibt Daten in das Feld und überschreibt alle vorhandenen Daten. Nachfolgende AppendChunk- Aufrufen vorhandene Daten hinzufügen. Wenn Sie Daten an ein Feld anfügen und dann den Wert eines anderen Felds im aktuellen Datensatz festlegen oder lesen, geht ADO davon aus, dass Sie mit dem Anfügen von Daten an das erste Feld fertig sind. Wenn Sie die AppendChunk- Methode für das erste Feld erneut aufrufen, interpretiert ADO den Aufruf als neue AppendChunk Vorgang und überschreibt die vorhandenen Daten. Der Zugriff auf Felder in anderen Recordset- Objekten, die keine Klonen des ersten Recordset--Objekts sind, wird AppendChunk--Vorgängen nicht gestört.

Wenn kein aktueller Datensatz vorhanden ist, wenn Sie AppendChunk- für ein Field-Objekt aufrufen, tritt ein Fehler auf.

Anmerkung

Die AppendChunk--Methode funktioniert nicht für Field-Objekte eines Record Object (ADO)- Objekts. Es führt keinen Vorgang aus und erzeugt einen Laufzeitfehler.

Parameter

Wenn das adParamLong- Bit in der eigenschaft Attributes eines Parameter--Objekts auf truefestgelegt ist, können Sie die methode AppendChunk für diesen Parameter verwenden.

Der erste AppendChunk- Aufruf eines Parameter- -Objekts schreibt Daten in den Parameter und überschreibt alle vorhandenen Daten. Nachfolgende AppendChunk- Aufrufe für ein Parameter Objekt vorhandenen Parameterdaten hinzufügen. Ein AppendChunk- Aufruf, der einen NULL-Wert übergibt, verwirft alle Parameterdaten.

Gilt für

Siehe auch

AppendChunk- und GetChunk-Methode (Vb-Beispiel)
AppendChunk- und GetChunk-Methoden (Beispiel) (VC++)
Attributes-Eigenschaft (ADO)
GetChunk-Methode (ADO)