Método GetChunk (ADO)
Retorna todo ou uma parte do conteúdo de um texto grande ou de dados binários objeto Field.
Sintaxe
variable = field.GetChunk(Size)
Valor retornado
Retorna um Variant.
Parâmetros
de tamanho de
Uma expressão Long igual ao número de bytes ou caracteres que você deseja recuperar.
Observações
Use o método GetChunk em um objeto Field para recuperar parte ou todos os seus dados binários ou de caractere 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, em vez de em sua totalidade.
Os dados que uma chamada GetChunk retorna são atribuídos a variável. Se Tamanho for maior que os dados restantes, o método GetChunk retornará apenas os dados restantes sem preenchimento variável com espaços vazios. Se o campo estiver vazio, o método GetChunk retornará um valor nulo.
Cada chamada GetChunk subsequente recupera dados que começam de onde a chamada GetChunk anterior parou. No entanto, se você estiver recuperando dados de um campo e, em seguida, definir ou ler o valor de outro campo no registro atual, o ADO pressupõ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 interpretará a chamada como uma nova operação de GetChunk e começará a ler desde o início dos dados. Acessar campos em outros objetos Recordset que não são clones do primeiro objeto Recordset não interromperá operações de GetChunk.
Se o adFldLong bit na propriedade Attributes de um objeto Field estiver definido como True, você poderá usar o método GetChunk para esse campo.
Se não houver nenhum registro atual quando você usar o método GetChunk em um objeto Field, ocorrerá o erro 3021 (nenhum registro atual).
Nota
O método GetChunk não opera em objetos de campo de de um objeto de registro de. Ele não executa nenhuma operação e produzirá um erro em tempo de execução.
Aplica-se a
Consulte Também
exemplo dos métodos AppendChunk e GetChunk (VB)
exemplo dos métodos AppendChunk e GetChunk (VC++)
método AppendChunk (ADO)
propriedade Attributes (ADO)