Méthode GetChunk (ADO)

S’applique à : Access 2013, Office 2013

Retourne l’ensemble ou une partie du contenu d’un objet Field volumineux contenant du texte ou des données binaires.

Syntaxe

Variable = champ. GetChunk(Size )

Valeur renvoyée

Retourne une valeur de type Variant.

Paramètres

Remarques

Utilisez la méthode GetChunk sur un objet Field pour en extraire toute ou partie des données binaires ou de caractères longues. Si vous manquez de mémoire système, vous pouvez utiliser la méthode GetChunk pour manipuler une partie des valeurs longues plutôt que leur totalité.

Les données qu'un appel à la méthode GetChunk retourne sont assignées à une variable. Si Taille est supérieur aux données restantes, la méthode GetChunk retourne uniquement les données restantes sans remplir la variable avec des espaces vides. Si le champ est vide, la méthode GetChunk renvoie une valeur nulle.

Chaque appel à GetChunk ultérieur récupère les données à partir de l'emplacement où l'appel à GetChunk précédent s'est arrêté. Toutefois, si vous récupérez des données d'un champ et qu'ensuite vous définissez ou lisez la valeur d'un autre champ dans l'enregistrement actif, ADO suppose que vous avez terminé de récupérer les données du premier champ. Si vous appelez de nouveau la méthode GetChunk sur le premier champ, ADO interprète l'appel comme une nouvelle opération GetChunk et recommence sa lecture à partir du début des données. L'accès aux champ d'autres objets Recordset non identiques au premier objet Recordset n'interrompt pas les opérations GetChunk.

Si le bit adFldLong de 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 en cours) se produit.