ADO GetChunk-metodi

Määrittely ja käyttö

GetChunk-metodi voi palauttaa variant-arvon, joka sisältää suuren tekstin tai binääritiedon Field-objektin koko tai osan sisällön.

Käytä Field-objektin GetChunk-metodia osittaiseen tai täydelliseen pitkän binääri- tai merkkidatan hakemiseen. Jos järjestelmän muistia on rajallinen, voit käyttää GetChunk-metodia käsittelemään vain osaa pitkistä arvoista.

GetChunk-kutsun palauttamat tiedot annetaan muuttujalle. Jos koko on suurempi kuin jäljellä oleva tieto, GetChunk-metodi palauttaa vain jäljellä olevan tiedon eikä täytä muuttujaa välilyönneillä. Jos kenttä on tyhjä, GetChunk-metodi palauttaa Null-arvon.

Jokainen seuraava GetChunk-kutsu aloittaa tiedon hakemisen edellisen GetChunk-kutsun lopusta. Jos kuitenkin haetaan tietoja yhdessä kentästä ja asetetaan tai lukea toisen kentän arvo, ADO katsoo, että ensimmäisen kentän tiedon hakeminen on päättynyt. Jos GetChunk-metodia kutsutaan uudelleen ensimmäisessä kentässä, ADO tulkitssee tämän uudeksi GetChunk-toiminnoksi ja lukee tiedot alusta. Muissa Recordset-objekteissa (ei ensimmäisen Recordset-objektin kopioiduissa) olevien kenttien käsittely ei keskeytä GetChunk-toimintoa.

Jos Field-objektin Attributes-ominaisuuden adFldLong-arkki asetetaan True, GetChunk-metodia voidaan käyttää tälle kentälle.

huomautus:Jos käytät Field-objektin GetChunk-metodia ilman nykyistä tietuetta, virhe 3021 (ei ole nykyistä tietuetta) ilmenee.

huomautus:GetChunk-metodi ei vaikuta Record-objektin Field-objektiin. Se ei tee mitään ja aiheuttaa ajon aikainen virhe.

syntaksi

variable_name=field.GetChunk(size)
parametrit kuvaus
size pitkä lauseke, yhtä suuri kuin haettavien tietojen määrä (bittiä tai merkkiä).