Compartilhar via


Método AppendChunk (ADO)

Acrescenta dados a um texto grande ou dados binários fieldou a um objeto de parâmetro de.

Sintaxe

  
object.AppendChunk Data  

Parâmetros

de objeto
Um objeto de parâmetro de ou de campo de.

data
Um variant que contém os dados a serem acrescentados ao objeto.

Observações

Use o método AppendChunk em um objeto de campo de ou parâmetro para preenchê-lo com dados binários ou de caracteres longos. Em situações em que a memória do sistema é limitada, você pode usar o método AppendChunk para manipular valores longos em partes e não em sua totalidade.

Campo

Se o adFldLong bit na propriedade Attributes de um objeto de campo estiver definido como verdadeiro, você poderá usar o método AppendChunk para esse campo.

A primeira chamada AppendChunk em um objeto Field grava dados no campo, substituindo os dados existentes. Chamadas AppendChunk subsequentes adicionadas aos dados existentes. Se você estiver acrescentando dados a um campo e, em seguida, definir ou ler o valor de outro campo no registro atual, o ADO pressupõe que você terminou 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. Acessar campos em outros objetos recordset que não são clones do primeiro objeto Recordset não interromperá operações de AppendChunk.

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

Nota

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

Parâmetro

Se o adParamLong bit na propriedade Attributes de um objeto Parameter estiver definido como verdadeiro, você poderá usar o método AppendChunk para esse parâmetro.

A primeira chamada AppendChunk em um objeto Parameter grava dados no parâmetro, substituindo os dados existentes. Chamadas AppendChunk subsequentes em um objeto Parameter adicionado aos dados de parâmetro existentes. Uma chamada AppendChunk que passa um valor nulo descarta todos os dados de parâmetro.

Aplica-se a

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)