AppendChunk, méthode (ADO)

Ajoute des données à un texte volumineux ou des données binaires Field, ou à un objet Parameter.

Syntaxe

  
object.AppendChunk Data  

Paramètres

objet
Objet Field ou Parameter .

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

Remarques

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

Terrain

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 les données existantes. Les appels AppendChunk suivants viennent s'ajouter 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 d’autres objets Recordset qui ne sont pas des clones du premier objet Recordset n’interrompt pas les opérations AppendChunk.

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

Remarque

La méthode AppendChunk ne fonctionne pas sur les objets Field d’un objet Objet Record (ADO). Elle 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 paramètre.

Le premier appel AppendChunk sur un objet Parameter écrit des données dans le paramètre, 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.

S’applique à

Objet Field

'objet Parameter

Voir aussi

AppendChunk et GetChunk, méthodes - Exemple (VB)
AppendChunk et GetChunk, méthodes - Exemple (VC++)
Attributes, propriété (ADO)
GetChunk, méthode (ADO)