Méthode AppendChunk ADO

Définition et utilisation

AppendChunk est utilisé pour ajouter des données à de grandes données de texte ou binaires dans un champ ou à un objet Parameter.

Conseil : Utilisez la méthode AppendChunk des objets Field ou Parameter pour remplir des données binaires ou des caractères longs. 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 réglé sur True, vous pouvez utiliser la méthode AppendChunk pour ce paramètre.

La première appel de AppendChunk sur l'objet Parameter écrit des données dans le paramètre, en couvrant tout données existantes. Les appels ultérieurs de AppendChunk sur l'objet Parameter ajoutent des données aux données de paramètres existantes. L'appel de AppendChunk avec une valeur Null abandonne toutes les données de paramètres.

Field

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

La première appel de AppendChunk sur l'objet Field écrit des données dans le champ, en couvrant tout données existantes. Les appels ultérieurs de AppendChunk ajoutent des données à des 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 AppendChunk méthode est appelée à nouveau sur le premier champ, ADO interprète cette appel comme une nouvelle opération AppendChunk et couvre les données existantes. L'accès aux champs d'autres objets Recordset (autre que des copies de la première objet Recordset) ne rompt pas l'opération AppendChunk.

Lorsque AppendChunk est appelé sur l'objet Field, si il n'y a pas d'enregistrement actuel, une erreur se produira.

Attention : la méthode AppendChunk n'a pas d'effet sur l'objet Field de l'objet Record. Elle ne réalise aucune opération et produira une erreur en temps réel.

Syntaxe

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