AppendChunk, méthode (ADO)

Article
05/30/2023

Ajoute des données à un grand ensemble de données textuelles Field ou binaires, ou à un objet Parameter.

Syntaxe

  
object.AppendChunk Data

Paramètres

object
Objet Field ou Parameter.

Données
Variant qui contient les données à ajouter à l’objet.

Notes

Utilisez la méthode AppendChunk sur un objet Fieldou Parameter pour le remplir avec des données de caractères ou binaires longues. Dans les situations où la mémoire système est limitée, vous pouvez utiliser la méthode AppendChunk pour manipuler des valeurs longues par portions plutôt que dans leur intégralité.

Champ

Si le bit adFldLong dans la propriété Attributes d’un objet Field a la valeur True, vous pouvez utiliser la méthode AppendChunk pour ce champ.

Le premier appel AppendChunk sur un objet Field écrit des données dans le champ, en remplaçant toutes les données existantes. Les appels AppendChunk suivants ajoutent aux données existantes. Si vous ajoutez des données à un champ, puis que vous définissez ou lisez la valeur d’un autre champ dans l’enregistrement actif, ADO suppose que vous avez terminé d’ajouter des données au premier champ. Si vous appelez à nouveau la méthode AppendChunk sur le premier champ, ADO interprète l’appel comme une nouvelle opération AppendChunk et remplace les données existantes. L’accès aux champs dans d’autres objets Recordset qui ne sont pas clones du premier objet Recordset n’interrompt pas les opérations AppendChunk.

S’il n’existe aucun enregistrement actuel lorsque vous appelez AppendChunk sur un objet Field, une erreur se produit.

Notes

La méthode AppendChunk ne fonctionne pas sur les objets Field d’un objet Record Object (ADO). Il n’effectue aucune opération et génère une erreur d’exécution.

Paramètre

Si le bit adParamLong dans la propriété Attributes d’un objet Parameter a la valeur True, vous pouvez utiliser la méthode AppendChunk pour ce champ.

Le premier appel AppendChunk sur un objet Parameter écrit des données dans le champ, en remplaçant toutes les données existantes. Les appels AppendChunk suivants sur un objet Parameter ajoutent aux données de paramètre existantes. Un appel AppendChunk qui transmet une valeur Null ignore toutes les données de paramètre.