Méthode AppendChunk ADO

Définition et utilisation

AppendChunk est utilisé pour ajouter des données à un grand champ de texte ou binaire ou à un objet Parameter.

Avis :Utilisez la méthode AppendChunk de l'objet Field ou Parameter pour remplir avec des données binaires ou textuelles longues. Dans le cas où la mémoire système est limitée, vous pouvez utiliser la méthode AppendChunk pour manipuler une partie des valeurs Long au lieu de toutes.

Objet Description de la méthode AppendChunk
Parameter

Si le bit adFldLong de l'attribut Attributes de l'objet Parameter est configuré sur True, vous pouvez utiliser la méthode AppendChunk pour ce paramètre.

La première appel de AppendChunk sur l'objet Parameter écrit les données dans le paramètre, en remplaçant toute donnée existante. Les appels ultérieurs de AppendChunk sur l'objet Parameter ajoutent des données aux données de paramètre existantes. Les appels de AppendChunk avec une valeur Null abandonnent toutes les données de paramètre.

Field

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

La première appel de AppendChunk sur l'objet Field écrit les données dans le champ, en remplaçant toute donnée existante. Les appels ultérieurs de AppendChunk ajoutent des données à la données existantes. Si vous devez ajouter des données à un champ et définir ou lire la valeur d'autres champs dans le même enregistrement, ADO considère que l'ajout de données à la première champ est terminé. Si l'appel de AppendChunk est à nouveau appelé sur le premier champ, ADO interprète cette appel comme une nouvelle opération AppendChunk et remplace les données existantes. L'accès aux champs d'autres objets Recordset (autre que les copies de la première Recordset) ne perturbe pas l'opération AppendChunk.

Un erreur se produira si il n'y a pas d'enregistrement courant lors de l'appel AppendChunk sur l'objet Field.

Attention : la méthode AppendChunk n'a pas d'effet sur l'objet Field du Record. Elle ne réalise aucune opération et entraînera une erreur de temps d'exécution.

Syntaxe

objectname.AppendChunk data
Paramètres Description
data Variant, contient les données à ajouter à l'objet.