GetChunk-Methode (ADO)
Gibt alle oder einen Teil des Inhalts eines großen Texts oder binärer Daten Field -Objekt zurück.
Syntax
variable = field.GetChunk(Size)
Rückgabewert
Gibt einen Variant-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 zugehörigen 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 zu bearbeiten, anstatt in ihrer Gesamtheit.
Die Daten, die ein GetChunk-aufruf zurückgibt, wird Variablenzugewiesen. Wenn Size größer als die verbleibenden Daten ist, gibt die GetChunk--Methode nur die verbleibenden Daten zurück, ohne Variable leerer Leerzeichen zu auffüllen. Wenn das Feld leer ist, gibt die GetChunk--Methode einen NULL-Wert zurück.
Bei jedem nachfolgenden GetChunk Aufruf werden Daten abgerufen, von denen die vorherige GetChunk Anruf unterbrochen wurde. 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 für das erste Feld erneut aufrufen, interpretiert ADO den Aufruf als neuen GetChunk Vorgang und beginnt mit dem Lesen von Anfang der Daten. Der Zugriff auf Felder in anderen Recordset--Objekten, die keine Klonen des ersten Recordset--Objekts sind, wird GetChunk--Vorgängen nicht gestört.
Wenn das adFldLong Bit in der eigenschaft Attributes eines Field-Objekts auf Truefestgelegt ist, können Sie die GetChunk-Methode für dieses Feld verwenden.
Wenn es keinen aktuellen Datensatz gibt, wenn Sie die GetChunk--Methode für ein Field-Objekt verwenden, tritt Fehler 3021 (kein aktueller Datensatz) auf.
Anmerkung
Die GetChunk--Methode funktioniert nicht für Field-Objekte eines Record-Objekts. Es führt keinen Vorgang aus und erzeugt einen Laufzeitfehler.
Gilt für
Siehe auch
AppendChunk- und GetChunk-Methode (Vb-Beispiel)
AppendChunk- und GetChunk-Methoden (Beispiel) (VC++)
AppendChunk-Methode (ADO)
Attributes-Eigenschaft (ADO)