GetRows, méthode (ADO)

  • Article

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
facultatif. Valeur GetRowsOptionEnum qui indique le nombre d’enregistrements à récupérer. La valeur par défaut est adGetRowsRest.

Start
facultatif. Valeur Chaîne ou Variant qui prend la valeur du signet de l’enregistrement à partir duquel l’opération GetRows doit commencer. Vous pouvez également utiliser une valeur BookmarkEnum .

Fields
facultatif. Variant qui représente un nom de champ unique ou une position ordinale, ou un tableau de noms de champs ou de nombres de positions ordinales. ADO retourne uniquement les données de ces champs.

Notes

Utilisez la méthode GetRows pour copier des enregistrements d’un Recordset dans un tableau à deux dimensions. Le premier indice identifie le champ et le second identifie le numéro d’enregistrement. La variable de 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 ceux 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 Démarrer .

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 a la valeur True s’il n’y a plus d’enregistrements.

S'applique à

Recordset, objet (ADO)

Voir aussi

GetRows, exemple de méthode (VB)
GetRows, exemple de méthode (VC++)