AppendChunk, méthode (ADO)
S’applique à : Access 2013, Office 2013
Cette méthode ajoute des données à un objet Field de données binaires ou de texte volumineux ou à un objet Parameter.
Syntaxe
*object.*AppendChunk Data
Paramètres
Paramètre | Description |
---|---|
object | Objet Field ou Parameter. |
Data | Variant contenant les données à ajouter à l'objet. |
Remarques
Use the AppendChunk method on a Field or Parameter object to fill it with long binary or character data. In situations where system memory is limited, you can use the AppendChunk method to manipulate long values in portions rather than in their entirety.
Field
Si le bit adFldLong de la propriété Attributes d'un objet Field a la valeur true, vous pouvez appliquer la méthode AppendChunk à ce champ.
The first AppendChunk call on a Field object writes data to the field, overwriting any existing data. Les invocations suivantes de AppendChunk s'ajoutent aux données existantes. Si vous ajoutez des données à un champ, puis définissez ou lisez la valeur d'un autre champ de l'enregistrement actif, ADO suppose que vous avez terminé l'ajout de données dans le premier champ. Si vous invoquez à nouveau la méthode AppendChunk sur le premier champ, ADO interprète l'invocation comme une nouvelle opération AppendChunk et écrase les données existantes. Accessing fields in other Recordset objects that are not clones of the first Recordset object will not disrupt AppendChunk operations.
S'il n'existe pas d'enregistrement actif lorsque vous appelez la méthode AppendChunk sur un objet Field, une erreur se produit.
Remarque
La méthode AppendChunk ne fonctionne pas sur les objets Field d’un objet Record . Elle n'exécute aucune opération et génère une erreur d'exécution.
Paramètres
Si le bit adParamLong de la propriété Attributes d'un objet Parameter a la valeur true, vous pouvez utiliser la méthode AppendChunk pour ce paramètre.
The first AppendChunk call on a Parameter object writes data to the parameter, overwriting any existing data. Subsequent AppendChunk calls on a Parameter object add to existing parameter data. An AppendChunk call that passes a null value discards all of the parameter data.