Comment : initialiser un tableau en escalier

Mise à jour : novembre 2007

Lorsque vous initialisez une variable tableau en escalier, vous pouvez spécifier les longueurs de dimension uniquement pour le tableau de niveau supérieur. Vous pouvez effectuer cette opération de plusieurs manières :

Pour initialiser une variable tableau en escalier

• Dans la déclaration de variable tableau, spécifiez la limite supérieure d'index de niveau supérieur à l'intérieur de la première paire de parenthèses, séparée par des virgules. L'exemple suivant déclare et crée une variable pour contenir un tableau en escalier d'éléments Byte en spécifiant uniquement la limite supérieure de niveau supérieur.

  Dim rainfall(11)() As Byte
  

  Après l'exécution de cette instruction, le tableau dans la variable rainfall contient 12 éléments, chacun correspondant à un tableau vide d'éléments Byte.

  - ou -

• Dans la clause New, spécifiez la limite supérieure d'index de niveau supérieur à l'intérieur de la première paire de parenthèses et ajoutez des accolades vides ({}). L'exemple suivant déclare et crée une variable pour contenir un tableau en escalier d'éléments Short en spécifiant uniquement la limite supérieure de niveau supérieur.

  Dim snowfall()() As Short = New Short(11)() {}
  

  Après l'exécution de cette instruction, le tableau dans la variable snowfall contient 12 éléments, chacun correspondant à un tableau vide d'éléments Short.

  Remarque :
  Vous pouvez initialiser la limite supérieure d'index de niveau supérieur dans un seul emplacement. Si vous spécifiez une limite supérieure dans les parenthèses qui suivent le nom de variable tableau, vous ne pouvez pas utiliser de clause New. Si vous spécifiez la limite supérieure dans les parenthèses dans la clause New, vous devez laisser vide les parenthèses qui suivent le nom de variable.

  - ou -

• Dans la clause New, spécifiez la limite supérieure d'index de niveau supérieur à l'intérieur des parenthèses et fournissez les valeurs d'élément à l'intérieur des accolades ({}). L'exemple suivant déclare, crée, et initialise une variable destinée à contenir un tableau en escalier d'éléments Char en spécifiant la limite supérieure de niveau supérieur et les valeurs. Notez les clauses New imbriquées pour initialiser les tableaux de niveau inférieur.

  Dim decodeValues()() As Char = New Char(1)() {New Char() {"a"c, "b"c}, New Char() {"p"c, "q"c}}
  

  Après l'exécution de cette instruction, le tableau dans la variable decodeValues contient deux éléments, chacun correspondant à un tableau Char de longueur 1 avec l'élément à index 0 contenant une valeur initialisée. Si vous fournissez à la fois la limite supérieure de niveau supérieur et les valeurs, vous devez inclure une valeur pour chaque élément de niveau supérieur de l'index 0 jusqu'à la limite supérieure.

  - ou -

• Dans la clause New, omettez les parenthèses de niveau supérieur et fournissez les valeurs d'élément à l'intérieur des accolades ({}). L'exemple suivant déclare, crée et initialise une variable pour contenir un tableau en escalier d'éléments Byte en spécifiant uniquement les valeurs d'élément. Notez les deux niveaux d'accolades dans la clause New.

  Dim firstValues()() As Byte = {New Byte() {2, 1}, New Byte() {3, 0}}
  

  Après l'exécution de cette instruction, la longueur du tableau dans la variable firstValues est de 2 avec les éléments firstValues(0) et firstValues(1). Chacun des éléments est initialisé avec un tableau Byte de deux éléments, le premier avec des valeurs d'élément 2 et 1 et le second avec des valeurs d'élément 3 et 0.

Voir aussi

Tâches

Comment : déclarer une variable tableau

Comment : créer un tableau de tableaux

Comment : initialiser une variable tableau

Comment : initialiser un tableau multidimensionnel

Dépannage des tableaux

Concepts

Tableaux en escalier dans Visual Basic

Écriture d'un code conforme CLS

Référence

New (Visual Basic)

Autres ressources

Tableaux dans Visual Basic