Information.UBound, méthode

Article
08/21/2007

Retourne le plus grand indice disponible pour la dimension indiquée d'un tableau.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function UBound ( _
    Array As Array, _
    <OptionalAttribute> Optional Rank As Integer = 1 _
) As Integer
'Utilisation
Dim Array As Array
Dim Rank As Integer
Dim returnValue As Integer

returnValue = Information.UBound(Array, Rank)

public static int UBound (
    Array Array,
    [OptionalAttribute] int Rank
)

public:
static int UBound (
    Array^ Array, 
    [OptionalAttribute] int Rank
)

public static int UBound (
    Array Array, 
    /** @attribute OptionalAttribute() */ int Rank
)

public static function UBound (
    Array : Array, 
    Rank : int
) : int

Paramètres

Array
Obligatoire. Tableau de tout type de données. Tableau dans lequel vous voulez trouver le plus grand indice possible d'une dimension.

Rank
Facultatif. Integer. Dimension pour laquelle le plus grand indice possible doit être retourné. Utilisez la valeur 1 pour la première dimension, la valeur 2 pour la deuxième, etc. Si Rank cet argument est omis, la position 1 est utilisée par défaut.

Valeur de retour

Integer. Valeur la plus élevée que l'indice pour la dimension spécifiée peut contenir. Si Array a un seul élément, UBound retourne 0. Si Array n'a pas d'éléments, par exemple, si c'est une chaîne de longueur nulle, UBound retourne -1.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic UBound, fonction (Visual Basic).

Compte tenu que les indices de tableau commencent à 0, la longueur d'une dimension est supérieure de un à l'indice le plus grand disponible pour cette dimension.

Pour un tableau avec les dimensions suivantes, UBound retourne les valeurs dans le tableau suivant :

Dim a(100, 5, 4) As Byte

Appel à UBound	Valeur de retour
`UBound(a, 1)`	100
`UBound(a, 2)`	5
`UBound(a, 3)`	4

Vous pouvez utiliser UBound pour déterminer le nombre total d'éléments dans un tableau, mais vous devez ajuster la valeur de retour pour prendre en compte le fait que les indices commencent à 0. L'exemple suivant calcule la taille totale du tableau a l'exemple précédent :

Dim total As Integer
total = (UBound(A, 1) + 1) * (UBound(A, 2) + 1) * (UBound(A, 3) + 1)

La valeur calculée pour total est 3 030, c'est-à-dire 101 * 6 * 5.

Exemple

Cet exemple utilise la fonction UBound pour déterminer le plus grand indice disponible pour la dimension indiquée d'un tableau.

Dim highest, bigArray(10, 15, 20), littleArray(6) As Integer
highest = UBound(bigArray, 1)
highest = UBound(bigArray, 3)
highest = UBound(littleArray)
' The three calls to UBound return 10, 20, and 6 respectively.

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Information, classe
Membres Information
Microsoft.VisualBasic, espace de noms
ArgumentException
RankException

Autres ressources

UBound, fonction (Visual Basic)
LBound, fonction (Visual Basic)
Dim, instruction (Visual Basic)
ReDim, instruction (Visual Basic)

Partager via