Méthode GetRows (ADO)
S’applique à : Access 2013, Office 2013
Récupère plusieurs enregistrements d’un objet Recordset dans un tableau.
Syntaxe
Array = recordset. GetRows(Rows, Start, Fields )
Valeur renvoyée
Retourne une valeur de type Variant qui représente un tableau à deux dimensions.
Paramètres
| Paramètre | Description |
|---|---|
| Rows | Facultatif. Valeur GetRowsOptionEnum qui indique le nombre d'enregistrements à récupérer. La valeur par défaut est adGetRowsRest. |
| Début | Facultatif. Valeur de type 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 | Facultatif. Variant qui représente un seul nom de champ ou position ordinale, ou un tableau de noms de champs ou de positions ordinales. ADO retourne uniquement les données de ces champs. |
Remarques
Utilisez la méthode GetRows pour copier des enregistrements d'un objet Recordset dans un tableau à deux dimensions. Le premier indice identifie le champ et le second le numéro d'enregistrement. La variable array 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 Lignes, la méthode GetRows récupère automatiquement tous les enregistrements de l'objet Recordset. Si vous demandez plus d'enregistrements que le nombre disponible, GetRows retourne uniquement le nombre d'enregistrements disponibles.
Si l’objet Recordset prend en charge les signets, vous pouvez spécifier à partir de quel enregistement la méthode GetRows doit commencer à récupérer les données en passant la valeur de la propriété Bookmark de cet enregistrement dans l’argument Début.
Si vous souhaitez limiter le nombre de champs retournés par l'appel de GetRows, vous pouvez passer un seul nom/numéro de champ ou un tableau de noms/numéros de champs dans l'argument Champs.
Après avoir appelé GetRows, l’enregistrement suivant non lu devient l’enregistrement actif ou, s’il n’y a plus aucun enregistrement, la propriété EOF a la valeur True.