Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Array.SetValue (Object, Int64)

 

Data di pubblicazione: ottobre 2016

Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array unidimensionale. L'indice viene specificato come intero a 64 bit.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

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

Parametri

value
Type: System.Object

Nuovo valore per l'elemento specificato.

index
Type: System.Int64

Intero a 64 bit che rappresenta la posizione dell'elemento Array da impostare.

Exception Condition
ArgumentException

L'oggetto Array corrente non ha esattamente una dimensione.

InvalidCastException

Non è possibile eseguire il cast di value al tipo di elemento dell'oggetto Array corrente.

ArgumentOutOfRangeException

index non è compreso nell'intervallo di indici validi per l'oggetto Array corrente.

Il GetLowerBound e GetUpperBound i metodi possono determinare se il valore di index è compreso nell'intervallo.

Per ulteriori informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione o (1).

System_CAPS_noteNota

Se SetValue viene utilizzato per assegnare null a un elemento di una matrice di tipi di valore, tutti i campi dell'elemento vengono inizializzati a zero. Il valore dell'elemento non è un riferimento null e non è possibile trovare eseguendo una ricerca per un riferimento null.

Esempio di codice riportato di seguito viene illustrato come impostare e ottenere un valore specifico in una matrice unidimensionale o multidimensionale.

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
Disponibile da 1.1
Torna all'inizio
Mostra: