Método AppendChunk do ADO

Definição e uso

AppendChunk é usado para adicionar dados a grandes campos de texto ou binários Field ou para objetos Parameter.

Dica:Use o método AppendChunk do objeto Field ou Parameter para preencher dados binários ou de caractere longos. Em situações onde a memória do sistema é limitada, você pode usar o método AppendChunk para operar em parte, não em todos os valores Long.

Objeto Descrição do método AppendChunk
Parameter

Se o bit adFldLong da propriedade Attributes do objeto Parameter estiver configurado como True, você pode usar o método AppendChunk para esse parâmetro.

A primeira chamada de AppendChunk no objeto Parameter escreve dados no parâmetro, substituindo qualquer dados existentes. As chamadas posteriores de AppendChunk no objeto Parameter adicionam dados aos dados de parâmetro existentes. A chamada de AppendChunk com valor Null desiste de todos os dados de parâmetro.

Field

Se o bit adFldLong da propriedade Attributes do objeto Field estiver configurado como True, você pode usar o método AppendChunk para esse campo.

A primeira chamada de AppendChunk no objeto Field escreve dados no campo, substituindo qualquer dados existentes. As chamadas posteriores de AppendChunk adicionam dados aos dados existentes. Se você deseja adicionar dados a um campo e, em seguida, definir ou ler valores de outros campos no registro atual, o ADO considera que a adição de dados ao primeiro campo foi concluída. Se a chamada AppendChunk for feita novamente no primeiro campo, o ADO interpretará essa chamada como uma nova operação AppendChunk e substituirá os dados existentes. Acesso a campos de outros objetos Recordset (não cópias do primeiro objeto Recordset) não interrompe a operação AppendChunk.

Ao chamar AppendChunk no objeto Field, se não houver registro atual, ocorrerá um erro.

Atenção: o método AppendChunk não afeta o objeto Field do objeto Record. Não executa nenhuma operação e gerará um erro de tempo de execução.

Sintaxe

objectname.AppendChunk data
Parâmetro Descrição
data Variant, contendo os dados a serem anexados ao objeto.