GetChunk, méthode (ADO)
Renvoie tout, ou une partie, du contenu d’un texte volumineux ou de données binaires Field objet.
Syntaxe
variable = field.GetChunk(Size)
Valeur de retour
Retourne un Variant.
Paramètres
taille
Expression long égale au nombre d’octets ou de caractères que vous souhaitez récupérer.
Remarques
Utilisez la méthode GetChunk sur un objet field Field pour récupérer une partie ou toutes ses 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 GetChunk pour manipuler de longues valeurs dans des parties, plutôt que dans leur intégralité.
Les données qu’un appel GetChunk renvoie sont affectées à variable. Si Taille est supérieure aux données restantes, la méthode GetChunk retourne uniquement les données restantes sans remplissage variable avec des espaces vides. Si le champ est vide, la méthode GetChunk retourne une valeur Null.
Chaque appel GetChunk suivant récupère les données à partir de l’endroit où l’appel GetChunk précédent est désactivé. Toutefois, si vous récupérez des données à partir d’un champ, puis que vous 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 d’autres Recordset objets qui ne sont pas des clones du premier objet recordset de n’interrompt pas les opérations de GetChunk.
Si le bit adFldLong dans la propriété Attributes d’un objet field est défini sur 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.
Note
La méthode GetChunk ne fonctionne pas sur objets Field d’un objet Record. Elle n’effectue aucune opération et génère une erreur d’exécution.
S’applique à
Voir aussi
AppendChunk et GetChunk, méthodes - Exemple (VB)
AppendChunk et GetChunk, méthodes - Exemple (VC++)
AppendChunk, méthode (ADO)
Attributes, propriété (ADO)