ADO GetChunk-methode
Definitie en gebruik
De GetChunk-methode kan een variant-waarde retourneren die de volledige of gedeeltelijke inhoud van de tekst of binair data van het Field-object bevat.
Gebruik de GetChunk-methode van het Field-object om een deel of het hele lange binair of character data te verkrijgen. Bij beperkte systeemgeheugen kan de GetChunk-methode worden gebruikt om een deel in plaats van het hele Long-waarde te bewerken.
De gegevens die door de GetChunk-aanroep worden geretourneerd, worden toegewezen aan variable. Als Size groter is dan de resterende gegevens, retourneert de GetChunk-methode alleen de resterende gegevens zonder variable op te vullen met spaties. Als het veld leeg is, retourneert de GetChunk-methode een Null-waarde.
Elke volgende GetChunk-aanroep begint met het ophalen van gegevens waar de vorige GetChunk-aanroep ophield. Als er echter gegevens worden opgehaald uit een veld in het huidige record en vervolgens een waarde van een ander veld wordt ingesteld of gelezen, wordt ADO ervan overtuigd dat de opname van gegevens uit het eerste veld is voltooid. Als de GetChunk-methode opnieuw wordt aangeroepen op het eerste veld, wordt deze aanroep geïnterpreteerd als een nieuwe GetChunk-operatie en worden gegevens vanaf het begin gelezen. Het raadplegen van velden in andere Recordset-objecten (niet kopieën van de eerste Recordset) onderbreekt niet de GetChunk-operatie.
Als de adFldLong-bit in de Attributes-eigenschap van het Field-object wordt ingesteld op True, kan de GetChunk-methode voor dit veld worden gebruikt.
opmerking:Als de GetChunk-methode van het Field-object wordt gebruikt zonder een huidig record, ontstaat er een fout 3021 (geen huidig record).
opmerking:De GetChunk-methode werkt niet op het Field-object van het Record-object. Het voert geen actie uit en veroorzaakt een runtime-fout.
syntaxis
variable_name=field.GetChunk(size)
parameter | beschrijving |
---|---|
grootte | Lang uitdrukking, gelijk aan het aantal bytes of karakters dat moet worden opgehaald. |