Método GetChunk (ADO)

Aplica-se ao: Access 2013, Office 2013

Retorna todo, ou uma porção de, o conteúdo de um grande objeto Field de dados binários ou texto.

Sintaxe

Variável = campo. GetChunk(Size )

Valor de retorno

Retorna uma Variant.

Parâmetros

Parâmetro	Descrição
Tamanho	Uma expressão Long que é igual ao número de bytes ou caracteres que você deseja recuperar.

Comentários

Use o método GetChunk em um objeto Field para recuperar parte ou todos os seus dados binários ou de caracteres longos. Em situações em que a memória do sistema é limitada, você pode usar o método GetChunk para manipular valores longos em partes, e não em sua totalidade.

Os dados retornados por GetChunk são atribuídos a variable. Se Size for maior que os dados restantes, o método GetChunk retornará somente esses dados sem preencher variable com espaços vazios. Se o campo estiver vazio, o método GetChunk retornará um valor nulo.

Cada chamada subsequente a GetChunk recupera os dados a partir de onde a chamada anterior a GetChunk foi suspensa. No entanto, se estiver recuperando dados a partir de um campo e, em seguida, definir ou ler o valor de outro campo no registro atual, o ADO supõe que você concluiu a recuperação de dados do primeiro campo. Se você chamar o método GetChunk no primeiro campo novamente, o ADO interpreta a chamada como uma nova operação GetChunk e começara a ler a partir do início dos dados. O acesso a campos em outros objetos Recordset que não sejam clones do primeiro objeto Recordset não interromperá as operações de GetChunk.

Se o bit adFldLong na propriedade Attributes de um objeto Field for definido como True, será possível utilizar o método GetChunk para esse campo.

Se não houver um registro atual ao utilizar o método GetChunk em um objeto Field, ocorrerá o erro 3021 (sem registro atual).

Observação

[!OBSERVAçãO] O método GetChunk não opera em objetos Field de um objeto Record. Ele não executa nenhuma operação e produzirá um erro em tempo de execução.