GetRows, méthode (ADO)
Récupère plusieurs enregistrements d’un objet Recordset dans un tableau.
Syntaxe
array = recordset.GetRows(Rows, Start, Fields )
Valeur de retour
Retourne un Variant dont la valeur est un tableau à deux dimensions.
Paramètres
lignes
Optionnel. Valeur GetRowsOptionEnum qui indique le nombre d’enregistrements à récupérer. La valeur par défaut est adGetRowsRest.
démarrer
Optionnel. Valeur string ou Variant qui correspond au signet de l’enregistrement à partir duquel l’opération getRows doit commencer. Vous pouvez également utiliser une valeur BookmarkEnum.
champs
Optionnel. Un Variant qui représente un nom de champ unique ou une position ordinale, ou un tableau de noms de champs ou de numéros de position ordinal. ADO retourne uniquement les données de ces champs.
Remarques
Utilisez la méthode GetRows pour copier des enregistrements à partir d’un jeu d’enregistrements dans un tableau à deux dimensions. Le premier indice identifie le champ et le deuxième identifie le numéro d’enregistrement. La variable tableau est automatiquement dimensionnée à la taille correcte lorsque la méthode GetRows retourne les données.
Si vous ne spécifiez pas de valeur pour l’argument Rows, la méthode GetRows récupère automatiquement tous les enregistrements de l’objet recordset. Si vous demandez plus d’enregistrements que disponibles, GetRows retourne uniquement le nombre d’enregistrements disponibles.
Si l’objet Recordset prend en charge les signets, vous pouvez spécifier à quel enregistrement la méthode GetRows doit commencer à récupérer des données en transmettant la valeur de la propriété Bookmark de cet enregistrement dans l’argument Start .
Si vous souhaitez restreindre les champs retournés par l’appel GetRows, vous pouvez passer un nom/numéro de champ unique ou un tableau de noms de champs/nombres dans l’argument Champs.
Après avoir appelé GetRows, l’enregistrement non lu suivant devient l’enregistrement actif ou la propriété EOF est définie sur True s’il n’y a plus d’enregistrements.
S’applique à
Voir aussi
GetRows, méthode - Exemple (VB)
GetRows, méthode - Exemple (VC++)