Método GetChunk (ADO)

Devuelve todo o parte del contenido de un objeto Field de texto grande o binario.

Sintaxis

  
variable = field.GetChunk(Size)  

Valor devuelto

Devuelve un valor Variant.

Parámetros

Tamaño
Una expresión Long que es igual al número de bytes o caracteres que desea recuperar.

Comentarios

Utilice el método GetChunk en un objeto Field para recuperar parte o todos sus datos binarios o de caracteres largos. En situaciones en las que la memoria del sistema es limitada, puede usar el método GetChunk para manipular valores largos en partes en lugar de en su totalidad.

Los datos que devuelve una llamada GetChunk se asignan a la variable. Si Size es mayor que los datos restantes, el método GetChunk devuelve solo los datos restantes sin rellenar la variable con espacios vacíos. Si el campo está vacío, el método GetChunk devuelve un valor NULL.

Cada llamada a GetChunk posterior recupera datos a partir de donde se dejó la llamada a GetChunk anterior. Sin embargo, si va a recuperar datos de un campo y, a continuación, establece o lee el valor de otro campo en el registro actual, ADO supone que ha terminado de recuperar datos del primer campo. Si llama de nuevo al método GetChunk en el primer campo, ADO interpreta la llamada como una nueva operación GetChunk y comienza a leer desde el principio de los datos. El acceso a campos de otros objetos Recordset que no son clones del primer objeto Recordset no interrumpirá las operaciones GetChunk.

Si el bit adFldLong de la propiedad Attributes de un objeto Field se establece en True, puede usar el método GetChunk para ese campo.

Si no hay ningún registro actual al usar el método GetChunk en un objeto Field, se produce el error 3021 (no hay ningún registro actual).

Nota

El método GetChunk no funciona en objetos Field de un objeto Record. No realiza ninguna operación y generará un error en tiempo de ejecución.

Se aplica a

Objeto Field

Consulte también

Ejemplo de los métodos AppendChunk y GetChunk (VB)
Ejemplo de los métodos AppendChunk y GetChunk (VC ++)
Método AppendChunk (ADO)
Propiedad Attributes (ADO)