Metodo GetChunk (ADO)

Restituisce tutto il contenuto o una parte del contenuto, di un oggetto Field di dati binari o di testo di grandi dimensioni.

Sintassi

  
variable = field.GetChunk(Size)  

Valore restituito

Restituisce un valore Variant.

Parametri

Size
Espressione Long uguale al numero di byte o caratteri che si vuole recuperare.

Osservazioni

Utilizzare il metodo GetChunk su un oggetto Field per recuperare parte o tutti i relativi dati binari o di tipo carattere lunghi. In situazioni in cui la memoria di sistema è limitata, è possibile usare il metodo GetChunk per modificare valori lunghi in parti anziché nell'intera dimensione.

I dati restituiti da una chiamata GetChunk vengono assegnati alla variabile. Se Size è maggiore dei dati rimanenti, il metodo GetChunk restituisce solo i dati rimanenti riempire la variabile con spazi vuoti. Se il campo è vuoto, il metodo GetChunk restituisce un valore Null.

Ogni chiamata GetChunk successiva recupera i dati a partire da dove è stata interrotta la precedente chiamata GetChunk. Tuttavia, se si recuperano dati da un campo e quindi si imposta o si legge il valore di un altro campo nel record corrente, ADO presuppone che sia stato completato il recupero dei dati dal primo campo. Se si chiama nuovamente il metodo GetChunk nel primo campo, ADO interpreta la chiamata come nuova operazione GetChunk e inizia la lettura dall'inizio dei dati. L'accesso ai campi in altri oggetti Recordset che non sono cloni del primo oggetto Recordset non interromperà le operazioni GetChunk.

Se il bit adFldLong nella proprietà Attributes di un oggetto Field è impostato su True, è possibile usare il metodo GetChunk per tale campo.

Se non è presente alcun record corrente quando si usa il metodo GetChunk in un oggetto Field, si verifica l'errore 3021 (nessun record corrente).

Nota

Il metodo GetChunk non opera sugli oggetti Field di un oggetto Record. Non esegue alcuna operazione e genera un errore di run-time.

Si applica a

Oggetto Field

Vedere anche

Esempio dei metodi AppendChunk e GetChunk (VB)
Esempio dei metodi AppendChunk e GetChunk (VC++)
Metodo AppendChunk (ADO)
Proprietà Attributes (ADO)