ADO GetChunk-metoden

Definition og brug

GetChunk-metoden kan returnere en variant-værdi, der indeholder hele eller en del af tekst- eller binærdataene i Field-objektet.

Brug GetChunk-metoden på Field-objektet til at hente en del eller hele længden af binær eller tegndata. Under begrænsede systemhukommelsesforhold kan GetChunk-metoden operere med en del af Long-værdierne i stedet for hele værdierne.

Data, der returneres af GetChunk-kaldet, vil blive tildelt til variablen. Hvis størrelsen er større end den resterende data, returnerer GetChunk-metoden kun de resterende data uden at fylde variablen med mellemrum. Hvis feltet er tomt, returnerer GetChunk-metoden Null-værdi.

Hver efterfølgende GetChunk-kald vil starte med at søge data fra det sted, hvor det forrige GetChunk-kald stoppede. Men hvis der søges efter data i et felt i det aktuelle record, og derefter sættes eller læses værdien af et andet felt, antager ADO, at den første del af dataene er blevet gennemgået. Hvis GetChunk-metoden kaldes igen på det første felt, fortolker ADO dette kald som en ny GetChunk-handling og læser fra datagens start. Adgang til felter i andre Recordset-objekter (ikke kopier af den første Recordset-objekt) vil ikke afbryde GetChunk-operationen.

Hvis adFldLong bitet i Field objektets Attributes egenskab er sat til True, kan GetChunk metoden bruges til dette felt.

Kommentar:Hvis der ikke er et aktuelt record, når Field objektets Getchunk metode bruges, vil der opstå fejl 3021 (ingen aktuelt record).

Kommentar:GetChunk metoden fungerer ikke på Field objektet i Record objektet. Den udfører ingen operationer og vil generere en runtime-fejl.

Syntaks

variable_name=field.GetChunk(size)
Parameter Beskrivelse
størrelse Lang udtryk, lig med det antal bytes eller tegn, der skal hentes.