Array.GetValue Metodo

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Ottiene il valore dell'elemento specificato nell'oggetto corrente Array.

Overload

Nome	Descrizione
GetValue(Int32)	Ottiene il valore in corrispondenza della posizione specificata nell'oggetto unidimensionale Array. L'indice viene specificato come intero a 32 bit.
GetValue(Int32[])	Ottiene il valore in corrispondenza della posizione specificata nell'oggetto multidimensionale Array. Gli indici vengono specificati come matrice di interi a 32 bit.
GetValue(Int64)	Ottiene il valore in corrispondenza della posizione specificata nell'oggetto unidimensionale Array. L'indice viene specificato come intero a 64 bit.
GetValue(Int64[])	Ottiene il valore in corrispondenza della posizione specificata nell'oggetto multidimensionale Array. Gli indici vengono specificati come matrice di interi a 64 bit.
GetValue(Int32, Int32)	Ottiene il valore in corrispondenza della posizione specificata nell'oggetto bidimensionale Array. Gli indici vengono specificati come interi a 32 bit.
GetValue(Int64, Int64)	Ottiene il valore in corrispondenza della posizione specificata nell'oggetto bidimensionale Array. Gli indici vengono specificati come interi a 64 bit.
GetValue(Int32, Int32, Int32)	Ottiene il valore in corrispondenza della posizione specificata nell'oggetto tridimensionale Array. Gli indici vengono specificati come interi a 32 bit.
GetValue(Int64, Int64, Int64)	Ottiene il valore in corrispondenza della posizione specificata nell'oggetto tridimensionale Array. Gli indici vengono specificati come interi 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 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

GetValue(Int32)

Origine:

Array.cs

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto unidimensionale Array. L'indice viene specificato come intero a 32 bit.

public:
 System::Object ^ GetValue(int index);

public object? GetValue(int index);

member this.GetValue : int -> obj

Public Function GetValue (index As Integer) As Object

Parametri

index

Int32

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

Valori restituiti

Object

Valore in corrispondenza della posizione specificata nell'oggetto unidimensionale Array.

Eccezioni

ArgumentException

L'oggetto corrente Array non ha esattamente una dimensione.

IndexOutOfRangeException

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

Commenti

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

Questo metodo è un'operazione O(1).

Vedi anche

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

GetValue(Int32[])

Origine:

Array.cs

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto multidimensionale Array. Gli indici vengono specificati come matrice di interi a 32 bit.

public:
 System::Object ^ GetValue(... cli::array <int> ^ indices);

public object? GetValue(params int[] indices);

member this.GetValue : int[] -> obj

Public Function GetValue (ParamArray indices As Integer()) As Object

Parametri

indices

Int32[]

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

Valori restituiti

Object

Valore in corrispondenza della posizione specificata nell'oggetto multidimensionale Array.

Eccezioni

ArgumentNullException

indices è null.

ArgumentException

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

IndexOutOfRangeException

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

Commenti

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

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici non è compreso nei limiti.

Questo metodo è un'operazione O(1).

Vedi anche

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

GetValue(Int64)

Origine:

Array.cs

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto unidimensionale Array. L'indice viene specificato come intero a 64 bit.

public:
 System::Object ^ GetValue(long index);

public object? GetValue(long index);

member this.GetValue : int64 -> obj

Public Function GetValue (index As Long) As Object

Parametri

index

Int64

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

Valori restituiti

Object

Valore in corrispondenza della posizione specificata nell'oggetto unidimensionale Array.

Eccezioni

ArgumentException

L'oggetto corrente Array non ha esattamente una dimensione.

ArgumentOutOfRangeException

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

Commenti

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

Questo metodo è un'operazione O(1).

Vedi anche

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

GetValue(Int64[])

Origine:

Array.cs

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto multidimensionale Array. Gli indici vengono specificati come matrice di interi a 64 bit.

public:
 System::Object ^ GetValue(... cli::array <long> ^ indices);

public object? GetValue(params long[] indices);

member this.GetValue : int64[] -> obj

Public Function GetValue (ParamArray indices As Long()) As Object

Parametri

indices

Int64[]

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

Valori restituiti

Object

Valore in corrispondenza della posizione specificata nell'oggetto multidimensionale Array.

Eccezioni

ArgumentNullException

indices è null.

ArgumentException

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

ArgumentOutOfRangeException

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

Commenti

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

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici non è compreso nei limiti.

Questo metodo è un'operazione O(1).

Vedi anche

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

GetValue(Int32, Int32)

Origine:

Array.cs

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto bidimensionale Array. Gli indici vengono specificati come interi a 32 bit.

public:
 System::Object ^ GetValue(int index1, int index2);

public object? GetValue(int index1, int index2);

member this.GetValue : int * int -> obj

Public Function GetValue (index1 As Integer, index2 As Integer) As Object

Parametri

index1

Int32

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

index2

Int32

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

Valori restituiti

Object

Valore in corrispondenza della posizione specificata nell'oggetto bidimensionale Array.

Eccezioni

ArgumentException

L'oggetto corrente Array non ha esattamente due dimensioni.

IndexOutOfRangeException

index1 Oppure index2 non è compreso nell'intervallo di indici validi per la dimensione corrispondente dell'oggetto correnteArray.

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici non è compreso nei limiti.

Questo metodo è un'operazione O(1).

Vedi anche

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

GetValue(Int64, Int64)

Origine:

Array.cs

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto bidimensionale Array. Gli indici vengono specificati come interi a 64 bit.

public:
 System::Object ^ GetValue(long index1, long index2);

public object? GetValue(long index1, long index2);

member this.GetValue : int64 * int64 -> obj

Public Function GetValue (index1 As Long, index2 As Long) As Object

Parametri

index1

Int64

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

index2

Int64

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

Valori restituiti

Object

Valore in corrispondenza della posizione specificata nell'oggetto bidimensionale Array.

Eccezioni

ArgumentException

L'oggetto corrente Array non ha esattamente due dimensioni.

ArgumentOutOfRangeException

index1 Oppure index2 non è compreso nell'intervallo di indici validi per la dimensione corrispondente dell'oggetto correnteArray.

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici non è compreso nei limiti.

Questo metodo è un'operazione O(1).

Vedi anche

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

GetValue(Int32, Int32, Int32)

Origine:

Array.cs

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto tridimensionale Array. Gli indici vengono specificati come interi a 32 bit.

public:
 System::Object ^ GetValue(int index1, int index2, int index3);

public object? GetValue(int index1, int index2, int index3);

member this.GetValue : int * int * int -> obj

Public Function GetValue (index1 As Integer, index2 As Integer, index3 As Integer) As Object

Parametri

index1

Int32

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

index2

Int32

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

index3

Int32

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

Valori restituiti

Object

Valore in corrispondenza della posizione specificata nell'oggetto tridimensionale Array.

Eccezioni

ArgumentException

L'oggetto corrente Array non ha esattamente tre dimensioni.

IndexOutOfRangeException

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

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici non è compreso nei limiti.

Questo metodo è un'operazione O(1).

Vedi anche

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

GetValue(Int64, Int64, Int64)

Origine:

Array.cs

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto tridimensionale Array. Gli indici vengono specificati come interi a 64 bit.

public:
 System::Object ^ GetValue(long index1, long index2, long index3);

public object? GetValue(long index1, long index2, long index3);

member this.GetValue : int64 * int64 * int64 -> obj

Public Function GetValue (index1 As Long, index2 As Long, index3 As Long) As Object

Parametri

index1

Int64

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

index2

Int64

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

index3

Int64

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

Valori restituiti

Object

Valore in corrispondenza della posizione specificata nell'oggetto tridimensionale Array.

Eccezioni

ArgumentException

L'oggetto corrente Array non ha esattamente tre dimensioni.

ArgumentOutOfRangeException

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

Commenti

I GetLowerBound metodi e GetUpperBound possono determinare se uno degli indici non è compreso nei limiti.

Questo metodo è un'operazione O(1).

Vedi anche

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue