Método GetChunk do ADO
Definição e uso
O método GetChunk pode retornar um valor variant que contém todo ou parte do conteúdo de dados de texto ou binários do objeto Field.
Use o método GetChunk do objeto Field para buscar parte ou todo o conteúdo de dados binários ou de caracteres longos. Em situações onde a memória do sistema é limitada, você pode usar o método GetChunk para operar com parte e não com todos os valores Long.
Os dados retornados pela chamada GetChunk serão alocados para a variável. Se o tamanho for maior que os dados restantes, o método GetChunk retornará apenas os dados restantes sem preencher a variável com espaços. Se o campo estiver vazio, o método GetChunk retornará o valor Null.
Cada chamada subsequente de GetChunk começará a buscar dados onde a última chamada de GetChunk parou. No entanto, se buscar dados de um campo em um registro atualmente e, em seguida, definir ou ler o valor de outro campo, o ADO considera que a busca pelos dados do primeiro campo foi concluída. Se chamar o método GetChunk novamente no primeiro campo, o ADO interpretará essa chamada como uma nova operação GetChunk e lerá os dados a partir do início. Acesso a campos em outros objetos Recordset (não cópias do primeiro objeto Recordset) não interromperá a operação GetChunk.
Se o bit adFldLong do atributo Attributes do objeto Field for configurado como True, o método GetChunk pode ser usado para esse campo.
Comentário:Se o método GetChunk do objeto Field for usado sem registro atual, será gerado o erro 3021 (nenhum registro atual).
Comentário:O método GetChunk não funciona no objeto Field do objeto Record. Não executa nenhuma ação e gerará um erro de tempo de execução.
Sintaxe
variable_name=field.GetChunk(size)
Parâmetro | Descrição |
---|---|
tamanho | Expressão Long, igual ao número de bytes ou caracteres a serem recuperados. |