Méthode GetChunk de ADO

Définition et utilisation

La méthode GetChunk peut retourner une valeur variant, qui contient la totalité ou une partie du contenu de grande taille de texte ou de données binaires du champ Field.

Utilisez la méthode GetChunk de l'objet Field pour rechercher une partie ou la totalité des données binaires ou de caractères longs. En cas de mémoire système limitée, vous pouvez utiliser la méthode GetChunk pour manipuler une partie plutôt que toute la valeur Long.

Les données retournées par l'appel GetChunk sont assignées à variable. Si la taille est supérieure aux données restantes, la méthode GetChunk ne retourne que les données restantes sans remplir variable avec des espaces. Si le champ est vide, la méthode GetChunk retourne une valeur Null.

Chaque appel suivant de GetChunk commence la recherche de données à partir de l'endroit où l'appel précédent de GetChunk s'est arrêté. Cependant, si vous recherchez des données dans un champ de l'enregistrement actuel puis définissez ou lisez la valeur d'un autre champ, ADO considère que la recherche des données du premier champ est terminée. Si vous appelez à nouveau la méthode GetChunk sur le premier champ, ADO interprète cette appel comme une nouvelle opération GetChunk et lit les données à partir du début. L'accès aux champs d'autres objets Recordset (autrement que des copies de la première instance de Recordset) ne rompt pas l'opération GetChunk.

Si le bit adFldLong de l'attribut Attributes de l'objet Field est réglé sur True, vous pouvez utiliser la méthode GetChunk pour ce champ.

Remarque :Si vous utilisez la méthode Getchunk de l'objet Field sans enregistrement actuel, une erreur 3021 (pas d'enregistrement actuel) se produira.

Remarque :La méthode GetChunk sur l'objet Field du Record n'a pas d'effet. Elle ne fait aucune opération et génère une erreur en temps d'exécution.

Syntaxe

variable_name=field.GetChunk(size)
Paramètres Description
taille Expression Long, égale au nombre d'octets ou de caractères à rechercher.