_Table.GetArray(Int32) Méthode

Définition

Obtient un tableau à deux dimensions qui contient un ensemble de valeurs de ligne et de colonne à partir du Table .

public:
 System::Object ^ GetArray(int MaxRows);
public object GetArray (int MaxRows);
Public Function GetArray (MaxRows As Integer) As Object

Paramètres

MaxRows
Int32

Spécifie le nombre maximal de lignes à renvoyer de l'objet Table.

Retours

Object

Valeur Object qui est un tableau à deux dimensions représentant un ensemble de valeurs de ligne et de colonne de la table. La première ligne du tableau est zéro ; l'indexation du tableau (i, j) s'effectue à partir de la ième ligne et de la jème colonne. Les colonnes du tableau correspondent aux colonnes de l'objet Table et les lignes, aux lignes de l'objet Table. Le nombre de lignes dans le tableau renvoyé est la valeur inférieure de et le nombre réel de lignes MaxRows dans le tableau.

Remarques

La méthode GetArray propose un moyen conceptuel simple d'obtenir des valeurs de l'objet Table en copiant tout ou partie des données de l'objet Table (en se basant sur la ligne active) dans un tableau et en les indexant dans ce tableau.

GetArray commence toujours sur la ligne active de l'objet Table. Elle renvoie un tableau avec le nombre de lignes si le tableau compte au moins un nombre de lignes commençant MaxRows MaxRows à la position actuelle. S'il n'est pas supérieur au nombre total de lignes dans le tableau et qu'il y a moins d'éléments dans le tableau à partir de la ligne actuelle, il retourne un tableau qui contient uniquement les lignes restantes du MaxRows MaxRows tableau. Si la méthode GetArray est appelée et qu'il n'existe aucune ligne restante, alors GetArray renvoie un tableau vide avec zéro élément.

Après l’obtention des lignes appropriées auprès de l’objet Table et avant son renvoi, GetArray repositionne toujours la ligne active sur la ligne suivante de l’objet Table, s’il existe une ligne suivante. GetArray(n) fonctionne comme s'il GetNextRow() était appelé n fois.

Les valeurs des colonnes correspondent aux colonnes de l’objet Table et sont donc déterminées par le format du nom de propriété utilisé pour la colonne. Pour plus d'informations, voir Factors Affecting Property Value Representation in the Table and View Classes

S’applique à