Método AppendChunk (ADO)

Acrescenta dados a um Field de dados binários ou de texto grande ou a um objeto Parameter.

Sintaxe

  
object.AppendChunk Data  

Parâmetros

object
Um objeto Field ou Parameter.

Dados
Uma Variant que contém os dados a serem acrescentados ao objeto.

Comentários

Use o método AppendChunk em um objeto Field ou Parameter para preenchê-lo com os dados de caracteres ou binários longos. Em situações em que a memória do sistema é limitada, use o método AppendChunk para processar valores longos em partes em vez da totalidade.

Campo

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

A primeira chamada AppendChunk em um objeto Field grava dados no campo, substituindo os dados existentes. As chamadas AppendChunk seguintes os adicionam aos dados existentes. Se você estiver acrescentando dados a um campo e definir ou ler o valor de outro campo no registro atual, o ADO vai pressupor que você tenha terminado de acrescentar dados ao primeiro campo. Se você chamar o método AppendChunk no primeiro campo novamente, o ADO interpretará a chamada como uma nova operação AppendChunk e substituirá os dados existentes. 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 AppendChunk.

Se não houver nenhum registro atual quando você chamar AppendChunk em um objeto Field, ocorrerá um erro.

Observação

O método AppendChunk não opera em objetos Field de um Objeto Record (ADO). Ele não executa nenhuma operação e produzirá um erro em tempo de execução.

Parâmetro

Se o bit adParamLong da propriedade Attributes de um objeto Parameter for definido como true, você poderá usar o método AppendChunk nesse parâmetro.

A primeira chamada a AppendChunk em um objeto Parameter grava os dados no parâmetro, substituindo os dados existentes. As chamadas posteriores a AppendChunk em um objeto Parameter adicionam os dados aos dados de parâmetro existentes. Uma chamada a AppendChunk que transmite um valor nulo descarta todos os dados de parâmetro.

Aplica-se A

Objeto Campo

Objeto Parameter

Consulte Também

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