Método AppendChunk (ADO)
Aplica-se ao: Access 2013, Office 2013
Acrescenta dados a um objeto Field ou Parameter de dados binários ou de texto longos.
Sintaxe
*object.*AppendChunk Data
Parâmetros
| Parâmetro | Descrição |
|---|---|
| objeto | Um objeto Field ou Parameter. |
| Data | Um Variant que contém os dados a serem acrescentados ao objeto. |
Comentários
Use the AppendChunk method on a Field or Parameter object to fill it with long binary or character data. In situations where system memory is limited, you can use the AppendChunk method to manipulate long values in portions rather than in their entirety.
Campo
Se o bit adFldLong na propriedade Attributes de um objeto Field for definido como true, você poderá usar o método AppendChunk para esse campo.
A primeira chamada de AppendChunk em um objeto Field grava dados no campo, substituindo os dados existentes. As chamadas subsequentes de AppendChunk fazem adições aos dados existentes. Se você estiver acrescentando dados a um campo e, depois, definir ou ler o valor de outro campo no registro atual, o ADO presumirá que o acréscimo de dados ao primeiro campo foi concluído. Se você chamar o método AppendChunk no primeiro campo novamente, o ADO interpretará a chamada como uma nova operação de AppendChunk e substituirá os dados existentes. O acesso a campos em outros objetos Recordset que não sejam clones do primeiro objeto Recordset não interromperá as operações de AppendChunk.
Um erro ocorrerá se não houver registro atual quando você chamar AppendChunk em um objeto Field.
Observação
[!OBSERVAçãO] O método AppendChunk não é operado nos objeto Field de um objeto Record. Ele não executa nenhuma operação e produzirá um erro em tempo de execução.
Parâmetros
Se o bit adParamLong na propriedade Attributes de um objeto Parameter for definido como true, você poderá usar o método AppendChunk para esse parâmetro.
A primeira chamada de AppendChunk em um objeto Parameter grava dados no parâmetro, substituindo os dados existentes. As chamadas subsequentes de AppendChunk em um objeto Parameter são adicionadas aos dados de parâmetro existentes. A chamada de AppendChunk que passar um valor nulo descartará todos os dados de parâmetro.