Array.SetValue Metodo

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Imposta l'elemento specificato nell'oggetto Array corrente sul valore specificato.

Overload

SetValue(Object, Int32)	Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array unidimensionale. L'indice viene specificato come intero a 32 bit.
SetValue(Object, Int32[])	Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array multidimensionale. Gli indici vengono specificati come una matrice di interi a 32 bit.
SetValue(Object, Int64[])	Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array multidimensionale. Gli indici vengono specificati come una matrice di valori interi a 64 bit.
SetValue(Object, Int32, Int32)	Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array bidimensionale. Gli indici vengono specificati come interi a 32 bit.
SetValue(Object, Int64, Int64)	Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array bidimensionale. Gli indici vengono specificati come interi a 64 bit.
SetValue(Object, Int32, Int32, Int32)	Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array tridimensionale. Gli indici vengono specificati come interi a 32 bit.
SetValue(Object, Int64, Int64, Int64)	Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array tridimensionale. Gli indici vengono specificati come interi a 64 bit.
SetValue(Object, Int64)	Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array unidimensionale. L'indice viene specificato come intero a 64 bit.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare e ottenere un valore specifico in una matrice unidimensionale o multidimensionale.

using namespace System;
int main()
{
   
   // Creates and initializes a one-dimensional array.
   array<String^>^myArr1 = gcnew array<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.
   array<String^, 2>^myArr2 = gcnew array<String^,2>(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.
   array<String^, 3>^myArr3 = gcnew array<String^,3>(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.
   array<String^, 7>^myArr7 = gcnew array<String^,7>(5,5,5,5,5,5,5);
   
   // Sets the element at index 1,2,3,0,1,2,3.
   array<Int32>^myIndices = {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

*/

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

*/

open System

// Creates and initializes a one-dimensional array.
let myArr1 = Array.zeroCreate<string> 5

// Sets the element at index 3.
myArr1.SetValue("three", 3)
printfn $"[3]:   {myArr1.GetValue 3}"

// Creates and initializes a two-dimensional array.
let myArr2 = Array2D.zeroCreate<string> 5 5

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

// Creates and initializes a three-dimensional array.
let myArr3 = Array3D.zeroCreate<string> 5 5 5

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

// Creates and initializes a seven-dimensional array.
let myArr7 = Array.CreateInstance(typeof<string>, 5, 5, 5, 5, 5, 5, 5)

// Sets the element at index 1,2,3,0,1,2,3.
let myIndices = [| 1; 2; 3; 0; 1; 2; 3 |]
myArr7.SetValue("one-two-three-zero-one-two-three", myIndices)
printfn $"[1,2,3,0,1,2,3]:   {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

Public Class SamplesArray

   Public Shared Sub Main()

      ' Creates and initializes a one-dimensional array.
      Dim myArr1(4) As [String]

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


      ' Creates and initializes a two-dimensional array.
      Dim myArr2(5, 5) As [String]

      ' 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.
      Dim myArr3(5, 5, 5) As [String]

      ' 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.
      Dim myArr7(5, 5, 5, 5, 5, 5, 5) As [String]

      ' Sets the element at index 1,2,3,0,1,2,3.
      Dim myIndices() As Integer = {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))

   End Sub

End Class


'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

SetValue(Object, Int32)

Origine:: Array.cs

Origine:: Array.cs

Origine:: Array.cs

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

public:
 void SetValue(System::Object ^ value, int index);

public void SetValue (object value, int index);

public void SetValue (object? value, int index);

member this.SetValue : obj * int -> unit

Public Sub SetValue (value As Object, index As Integer)

Parametri

value: Object

Nuovo valore per l'elemento specificato.

index: Int32

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

Eccezioni

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.

IndexOutOfRangeException

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

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se il valore di index è fuori dai limiti.

Per altre informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione O(1).

Nota

Se SetValue viene utilizzato per assegnare null a un elemento di una matrice di tipi valore, tutti i campi dell'elemento vengono inizializzati su zero. Il valore dell'elemento non è un riferimento Null e non può essere trovato cercando un riferimento Null.

Vedi anche

Si applica a

SetValue(Object, Int32[])

Origine:: Array.cs

Origine:: Array.cs

Origine:: Array.cs

Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array multidimensionale. Gli indici vengono specificati come una matrice di interi a 32 bit.

public:
 void SetValue(System::Object ^ value, ... cli::array <int> ^ indices);

public void SetValue (object value, params int[] indices);

public void SetValue (object? value, params int[] indices);

member this.SetValue : obj * int[] -> unit

Public Sub SetValue (value As Object, ParamArray indices As Integer())

Parametri

value: Object

Nuovo valore per l'elemento specificato.

indices: Int32[]

Matrice unidimensionale di interi a 32 bit che rappresentano gli indici che specificano la posizione dell'elemento da impostare.

Eccezioni

ArgumentNullException

indices è null.

ArgumentException

Il numero di dimensioni nell'oggetto Array corrente non è uguale al numero di elementi in indices.

InvalidCastException

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

IndexOutOfRangeException

Qualsiasi elemento in indices non è compreso nell'intervallo di indici validi per la dimensione corrispondente dell'oggetto Array corrente.

Commenti

Il numero di elementi in indices deve essere uguale al numero di dimensioni in Array. Tutti gli elementi nella indices matrice devono specificare collettivamente la posizione dell'elemento desiderato nell'oggetto multidimensionale Array.

I GetLowerBound metodi e GetUpperBound possono determinare se uno dei valori nella indices matrice non è compreso nei limiti.

Per altre informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione O(1).

Nota

Vedi anche

Si applica a

SetValue(Object, Int64[])

Origine:: Array.cs

Origine:: Array.cs

Origine:: Array.cs

Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array multidimensionale. Gli indici vengono specificati come una matrice di valori interi a 64 bit.

public:
 void SetValue(System::Object ^ value, ... cli::array <long> ^ indices);

public void SetValue (object? value, params long[] indices);

public void SetValue (object value, params long[] indices);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue (object value, params long[] indices);

member this.SetValue : obj * int64[] -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64[] -> unit

Public Sub SetValue (value As Object, ParamArray indices As Long())

Parametri

value: Object

Nuovo valore per l'elemento specificato.

indices: Int64[]

Matrice unidimensionale di valori interi a 64 bit che rappresentano gli indici che specificano la posizione dell'elemento da impostare.

Attributi: ComVisibleAttribute

Eccezioni

ArgumentNullException

indices è null.

ArgumentException

Il numero di dimensioni nell'oggetto Array corrente non è uguale al numero di elementi in indices.

InvalidCastException

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

ArgumentOutOfRangeException

Qualsiasi elemento in indices non è compreso nell'intervallo di indici validi per la dimensione corrispondente dell'oggetto Array corrente.

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno dei valori nella indices matrice non è compreso nei limiti.

Per altre informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione O(1).

Nota

Vedi anche

Si applica a

SetValue(Object, Int32, Int32)

Origine:: Array.cs

Origine:: Array.cs

Origine:: Array.cs

Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array bidimensionale. Gli indici vengono specificati come interi a 32 bit.

public:
 void SetValue(System::Object ^ value, int index1, int index2);

public void SetValue (object? value, int index1, int index2);

public void SetValue (object value, int index1, int index2);

member this.SetValue : obj * int * int -> unit

Public Sub SetValue (value As Object, index1 As Integer, index2 As Integer)

Parametri

value: Object

Nuovo valore per l'elemento specificato.

index1: Int32

Intero a 32 bit che rappresenta l'indice della prima dimensione dell'elemento Array da impostare.

index2: Int32

Intero a 32 bit che rappresenta l'indice della seconda dimensione dell'elemento Array da impostare.

Eccezioni

ArgumentException

L'oggetto Array corrente non ha esattamente due dimensioni.

InvalidCastException

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

IndexOutOfRangeException

index1 o index2 non è compreso nell'intervallo di indici validi per la dimensione corrispondente del valore di Array corrente.

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici è fuori dai limiti.

Per altre informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione O(1).

Nota

Vedi anche

Si applica a

SetValue(Object, Int64, Int64)

Origine:: Array.cs

Origine:: Array.cs

Origine:: Array.cs

Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array bidimensionale. Gli indici vengono specificati come interi a 64 bit.

public:
 void SetValue(System::Object ^ value, long index1, long index2);

public void SetValue (object? value, long index1, long index2);

public void SetValue (object value, long index1, long index2);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue (object value, long index1, long index2);

member this.SetValue : obj * int64 * int64 -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 * int64 -> unit

Public Sub SetValue (value As Object, index1 As Long, index2 As Long)

Parametri

value: Object

Nuovo valore per l'elemento specificato.

index1: Int64

Integer a 64 bit che rappresenta l'indice della prima dimensione dell'elemento Array da impostare.

index2: Int64

Integer a 64 bit che rappresenta l'indice della seconda dimensione dell'elemento Array da impostare.

Attributi: ComVisibleAttribute

Eccezioni

ArgumentException

L'oggetto Array corrente non ha esattamente due dimensioni.

InvalidCastException

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

ArgumentOutOfRangeException

index1 o index2 non è compreso nell'intervallo di indici validi per la dimensione corrispondente del valore di Array corrente.

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici è fuori dai limiti.

Per altre informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione O(1).

Nota

Vedi anche

Si applica a

SetValue(Object, Int32, Int32, Int32)

Origine:: Array.cs

Origine:: Array.cs

Origine:: Array.cs

Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array tridimensionale. Gli indici vengono specificati come interi a 32 bit.

public:
 void SetValue(System::Object ^ value, int index1, int index2, int index3);

public void SetValue (object? value, int index1, int index2, int index3);

public void SetValue (object value, int index1, int index2, int index3);

member this.SetValue : obj * int * int * int -> unit

Public Sub SetValue (value As Object, index1 As Integer, index2 As Integer, index3 As Integer)

Parametri

value: Object

Nuovo valore per l'elemento specificato.

index1: Int32

Intero a 32 bit che rappresenta l'indice della prima dimensione dell'elemento Array da impostare.

index2: Int32

Intero a 32 bit che rappresenta l'indice della seconda dimensione dell'elemento Array da impostare.

index3: Int32

Intero a 32 bit che rappresenta l'indice della terza dimensione dell'elemento Array da impostare.

Eccezioni

ArgumentException

L'oggetto Array corrente non ha esattamente tre dimensioni.

InvalidCastException

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

IndexOutOfRangeException

index1 o index2 o index3 non è compreso nell'intervallo di indici validi per la dimensione corrispondente dell'oggetto Array corrente.

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici è fuori dai limiti.

Per altre informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione O(1).

Nota

Vedi anche

Si applica a

SetValue(Object, Int64, Int64, Int64)

Origine:: Array.cs

Origine:: Array.cs

Origine:: Array.cs

Imposta un valore sull'elemento in corrispondenza della posizione specificata nell'oggetto Array tridimensionale. Gli indici vengono specificati come interi a 64 bit.

public:
 void SetValue(System::Object ^ value, long index1, long index2, long index3);

public void SetValue (object? value, long index1, long index2, long index3);

public void SetValue (object value, long index1, long index2, long index3);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue (object value, long index1, long index2, long index3);

member this.SetValue : obj * int64 * int64 * int64 -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 * int64 * int64 -> unit

Public Sub SetValue (value As Object, index1 As Long, index2 As Long, index3 As Long)

Parametri

value: Object

Nuovo valore per l'elemento specificato.

index1: Int64

Integer a 64 bit che rappresenta l'indice della prima dimensione dell'elemento Array da impostare.

index2: Int64

Integer a 64 bit che rappresenta l'indice della seconda dimensione dell'elemento Array da impostare.

index3: Int64

Integer a 64 bit che rappresenta l'indice della terza dimensione dell'elemento Array da impostare.

Attributi: ComVisibleAttribute

Eccezioni

ArgumentException

L'oggetto Array corrente non ha esattamente tre dimensioni.

InvalidCastException

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

ArgumentOutOfRangeException

index1 o index2 o index3 non è compreso nell'intervallo di indici validi per la dimensione corrispondente dell'oggetto Array corrente.

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici è fuori dai limiti.

Per altre informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione O(1).

Nota

Vedi anche

Si applica a

SetValue(Object, Int64)

Origine:: Array.cs

Origine:: Array.cs

Origine:: Array.cs

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

public:
 void SetValue(System::Object ^ value, long index);

public void SetValue (object? value, long index);

public void SetValue (object value, long index);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue (object value, long index);

member this.SetValue : obj * int64 -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 -> unit

Public Sub SetValue (value As Object, index As Long)

Parametri

value: Object

Nuovo valore per l'elemento specificato.

index: Int64

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

Attributi: ComVisibleAttribute

Eccezioni

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.

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se il valore di index è fuori dai limiti.

Per altre informazioni sulle conversioni, vedere Convert.

Questo metodo è un'operazione O(1).

Nota

Vedi anche

Si applica a

Condividi tramite

Array.SetValue Metodo

Definizione

Overload

Esempio

SetValue(Object, Int32)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

SetValue(Object, Int32[])

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

SetValue(Object, Int64[])

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

SetValue(Object, Int32, Int32)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

SetValue(Object, Int64, Int64)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

SetValue(Object, Int32, Int32, Int32)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

SetValue(Object, Int64, Int64, Int64)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

SetValue(Object, Int64)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Risorse aggiuntive