Freigeben über

GetChunk-Methode (ADO)

  • Artikel

Gibt den gesamten oder einen Teil des Inhalts eines großen Text- oder Binärdaten-Field-Objekts zurück.

Syntax

  
variable = field.GetChunk(Size)

Rückgabewert

Gibt einen Variant-Wert zurück.

Parameter

Größe
Ein Long-Ausdruck, der der Anzahl der Bytes oder Zeichen entspricht, die Sie abrufen möchten.

Bemerkungen

Verwenden Sie die GetChunk-Methode für ein Field-Objekt, um Teile oder alle seiner langen Binär- oder Zeichendaten abzurufen. In Situationen, in denen der Systemspeicher begrenzt ist, können Sie die GetChunk-Methode verwenden, um lange Werte in Teilen anstatt in ihrer Gesamtheit zu bearbeiten.

Die Daten, die ein GetChunk-Aufruf zurückgibt, werden einer Variablen zugewiesen. Wenn Size größer als die verbleibende Datenmenge ist, gibt die GetChunk-Methode nur die verbleibenden Daten zurück, ohne die Variable mit Leerzeichen aufzufüllen. Wenn das Feld leer ist, gibt die GetChunk-Methode einen Nullwert zurück.

Jeder nachfolgende GetChunk-Aufruf ruft Daten ab dem Punkt ab, wo der vorherige GetChunk-Anruf aufgehört hatte. Wenn Sie jedoch Daten aus einem Feld abrufen und dann den Wert eines anderen Felds im aktuellen Datensatz festlegen oder lesen, geht ADO davon aus, dass Sie das Abrufen von Daten aus dem ersten Feld abgeschlossen haben. Wenn Sie die GetChunk-Methode erneut für das erste Feld aufrufen, interpretiert ADO den Aufruf als neuen GetChunk-Vorgang und beginnt mit dem Lesen am Anfang der Daten. Der Zugriff auf Felder in anderen Recordset-Objekten, die keine Klone des ersten Recordset-Objekts sind, unterbricht GetChunk-Vorgänge nicht.

Wenn das adFldLong-Bit in der Attributes-Eigenschaft eines Field-Objekts auf True festgelegt ist, können Sie die GetChunk-Methode für dieses Feld verwenden.

Wenn kein aktueller Datensatz vorhanden ist, wenn Sie die GetChunk-Methode für ein Field-Objekt verwenden, tritt Fehler 3021 (kein aktueller Datensatz) auf.

Hinweis

Die GetChunk-Methode funktioniert nicht für Field-Objekte eines Record-Objekts. Sie führt keinen Vorgang aus und erzeugt einen Laufzeitfehler.

Gilt für

Field-Objekt

Weitere Informationen

AppendChunk and GetChunk Methods Example (VB)
AppendChunk- und GetChunk-Methode – Beispiel (VC++)
AppendChunk-Methode (ADO)
Attributes-Eigenschaft (ADO)