GetChunk-Methode (ADO)
Gilt für: Access 2013, Office 2013
Gibt den gesamten Inhalt oder einen Teil des Inhalts eines Field-Objekts mit umfangreichem Text oder Binärdaten zurück.
Syntax
Variable = -Feld. GetChunk(Size )
Rückgabewert
Gibt einen Variant-Wert zurück.
Parameter
| Parameter | Beschreibung |
|---|---|
| Größe | Ein Long -Ausdruck, der der Anzahl von Bytes oder Zeichen entspricht, die Sie abrufen möchten. |
Hinweise
Use the GetChunk method on a Field object to retrieve part or all of its long binary or character data. In situations where system memory is limited, you can use the GetChunk method to manipulate long values in portions, rather than in their entirety.
Die beim Aufrufen von GetChunk zurückgegebenen Daten werden Variable zugewiesen. Ist Size größer als die restlichen Daten, gibt die GetChunk-Methode nur die restlichen Daten zurück, ohne Variable mit Leerzeichen aufzufüllen. Falls das Feld leer ist, gibt die GetChunk -Methode einen NULL-Wert zurück.
Bei jedem weiteren Aufruf von GetChunk werden die Daten ab der Stelle abgerufen, an der beim vorherigen Aufruf von GetChunk abgebrochen wurde. Wenn Sie jedoch Daten aus einem Feld abrufen und anschließend 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 beendet haben. Wenn Sie die GetChunk -Methode erneut für das erste Feld aufrufen, interpretiert ADO den Aufruf als einen neuen GetChunk -Vorgang und beginnt am Anfang der Daten mit dem Lesen. Durch den Zugriff auf Felder in anderen Recordset -Objekten, die keine Klone des ersten Recordset -Objekts sind, werden GetChunk -Vorgänge nicht unterbrochen.
Besitzt das adFldLong -Bit in der Attributes-Eigenschaft eines Field -Objekts den Wert True, können Sie die GetChunk -Methode für dieses Feld verwenden.
Ist kein aktueller Datensatz vorhanden, wenn Sie die GetChunk -Methode für ein Field -Objekt verwenden, tritt Fehler 3021 (kein aktueller Datensatz) auf.
Hinweis
[!HINWEIS] Die GetChunk -Methode kann nicht auf Field -Objekte eines Record-Objekts angewendet werden. Sie führt keine Vorgänge aus und generiert einen Laufzeitfehler.