GetChunk, méthode (ADO)

Retourne tout, ou une partie, du contenu d’un objet Field de données texte ou binaire volumineux.

Syntaxe

  
variable = field.GetChunk(Size)  

Valeur de retour

Retourne une valeur Variant.

Paramètres

Taille
Une expression Long égale au nombre d’octets ou de caractères que vous souhaitez récupérer.

Notes

Utilisez la méthode GetChunk sur un objet Field pour récupérer une partie ou toutes ses 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 GetChunk pour manipuler des valeurs longues par portions plutôt que dans leur intégralité.

Les données retournées par un appel GetChunk sont affectées à une variable. Si la valeur Size est supérieure aux données restantes, la méthode GetChunk retourne uniquement les données restantes sans remplir variable avec des espaces vides. Si le champ est vide, la méthode GetChunk retourne une valeur null.

Chaque appel à GetChunk ultérieur récupère les données à partir de l’endroit où l’appel GetChunk précédent s’est arrêté. Toutefois, si vous récupérez des données à partir d’un champ, puis définissez ou lisez la valeur d’un autre champ dans l’enregistrement actif, ADO part du principe que vous avez fini de récupérer des données à partir du premier champ. Si vous appelez à nouveau la méthode GetChunk sur le premier champ, ADO interprète l’appel comme une nouvelle opération GetChunk et commence à lire à partir du début des données. 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 GetChunk.

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

S’il n’existe aucun enregistrement actif lorsque vous utilisez la méthode GetChunk sur un objet Field, l’erreur 3021 (aucun enregistrement actif) se produit.

S'applique à

Field, objet

Voir aussi

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