Método GetChunk (ADO)

Retorna todo o conteúdo, ou uma parte dele, de um objeto Field de dados binários ou de texto grande.

Sintaxe

  
variable = field.GetChunk(Size)  

Valor retornado

Retorna uma Variant.

Parâmetros

Tamanho
Uma expressão Long que é igual ao número de bytes ou de caracteres que você deseja recuperar.

Comentários

Use o método GetChunk em um objeto Field para recuperar parte ou todos os dados de caracteres ou binários longos. Em situações em que a memória do sistema é limitada, use o método GetChunk para processar valores longos em partes em vez da totalidade.

Os dados que uma chamada GetChunk retorna são atribuídos à variável. Se Size for maior que os dados restantes, o método GetChunk retornará apenas os dados restantes sem a variável de preenchimento com espaços vazios. Se o campo estiver vazio, o método GetChunk retornará um valor nulo.

Cada chamada GetChunk seguinte recupera dados que começam do ponto em que a chamada GetChunk anterior parou. No entanto, se você estiver recuperando dados de um campo e definir ou ler o valor de outro campo no registro atual, o ADO vai pressupor que você tenha terminado de recuperar os dados do primeiro campo. Se você chamar o método GetChunk no primeiro campo novamente, o ADO interpretará a chamada como uma nova operação GetChunk e começará a ler partindo do início dos dados. O acesso de campos em outros objetos Recordset que não são clones do primeiro objeto Recordset não interromperá as operações de GetChunk.

Se o bit adFldLong da propriedade Attributes de um objeto Field for definido como True, você poderá usar o método GetChunk nesse campo.

Se não houver nenhum registro atual quando você usar o método GetChunk em um objeto Field, ocorrerá o erro 3021 (nenhum registro atual).

Observação

O método GetChunk não opera em objetos Field de um objeto Record. Ele não executa nenhuma operação e produzirá um erro em tempo de execução.

Aplica-se A

Objeto Campo

Consulte Também

Exemplo dos métodos AppendChunk e GetChunk (VB)
Exemplo dos métodos AppendChunk e GetChunk (VC++)
Método AppendChunk (ADO)
Propriedade Attributes (ADO)