_Table.GetArray(Int32) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Obtient un tableau à deux dimensions qui contient un ensemble de valeurs de ligne et de colonne à partir de 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 retourné est la valeur inférieure de MaxRows et le nombre réel de lignes dans la table.

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 retourne un tableau avec MaxRows un nombre de lignes s’il existe au moins MaxRows un nombre de lignes dans la table commençant à la position actuelle. Si MaxRows n’est pas supérieur au nombre total de lignes dans la table et qu’il y a moins MaxRows d’éléments dans la table à partir de la ligne actuelle, il retourne un tableau qui contient uniquement les lignes restantes dans la table. 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 si 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, consultez Facteurs affectant la représentation des valeurs de propriété dans les classes table et vue.