Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Array.SetValue, méthode (Object, Int64)

 

Affecte une valeur à l'élément à la position spécifiée du Array unidimensionnel.L'index est spécifié en tant qu'entier 64 bits.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

[ComVisibleAttribute(false)]
public void SetValue(
	object value,
	long index
)

Paramètres

value

Nouvelle valeur de l'élément spécifié.

index

Entier 64 bits qui représente la position de l'élément Array à définir.

Exception Condition
ArgumentException

Le Array en cours ne possède pas exactement une dimension.

InvalidCastException

Le cast automatique de value en type d'élément du Array en cours est impossible.

ArgumentOutOfRangeException

index est en dehors de la plage d'index valide pour le Array en cours.

Le GetLowerBound et GetUpperBound méthodes peuvent déterminer si la valeur de index est hors limites.

Pour plus d'informations sur les conversions, consultez Convert.

Cette méthode est une opération o (1).

System_CAPS_noteRemarque

Si SetValue est utilisée pour affecter null à un élément d'un tableau de types valeur, tous les champs de l'élément sont initialisés à zéro.La valeur de l'élément n'est pas une référence null et ne peut pas être trouvée en recherchant une référence null.

L'exemple de code suivant montre comment définir et obtenir une valeur spécifique dans un tableau unidimensionnel ou multidimensionnel.

using System;

public class SamplesArray  {

   public static void Main()  {

      // Creates and initializes a one-dimensional array.
      String[] myArr1 = new String[5];

      // Sets the element at index 3.
      myArr1.SetValue( "three", 3 );
      Console.WriteLine( "[3]:   {0}", myArr1.GetValue( 3 ) );


      // Creates and initializes a two-dimensional array.
      String[,] myArr2 = new String[5,5];

      // Sets the element at index 1,3.
      myArr2.SetValue( "one-three", 1, 3 );
      Console.WriteLine( "[1,3]:   {0}", myArr2.GetValue( 1, 3 ) );


      // Creates and initializes a three-dimensional array.
      String[,,] myArr3 = new String[5,5,5];

      // Sets the element at index 1,2,3.
      myArr3.SetValue( "one-two-three", 1, 2, 3 );
      Console.WriteLine( "[1,2,3]:   {0}", myArr3.GetValue( 1, 2, 3 ) );


      // Creates and initializes a seven-dimensional array.
      String[,,,,,,] myArr7 = new String[5,5,5,5,5,5,5];

      // Sets the element at index 1,2,3,0,1,2,3.
      int[] myIndices = new int[7] { 1, 2, 3, 0, 1, 2, 3 };
      myArr7.SetValue( "one-two-three-zero-one-two-three", myIndices );
      Console.WriteLine( "[1,2,3,0,1,2,3]:   {0}", myArr7.GetValue( myIndices ) );

   }

}


/* 
This code produces the following output.

[3]:   three
[1,3]:   one-three
[1,2,3]:   one-two-three
[1,2,3,0,1,2,3]:   one-two-three-zero-one-two-three

*/

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: