Array.GetValue Metodo

Definizione

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

Overload

GetValue(Int32)

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

GetValue(Int32[])

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

GetValue(Int64)

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

GetValue(Int64[])

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

GetValue(Int32, Int32)

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

GetValue(Int64, Int64)

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

GetValue(Int32, Int32, Int32)

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

GetValue(Int64, Int64, Int64)

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto Array tridimensionale. 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 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

*/
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)

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

public:
 System::Object ^ GetValue(int index);
public 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.

Restituisce

Object

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

Eccezioni

L'oggetto Array corrente non ha esattamente una dimensione.

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

Commenti

I GetLowerBound metodi e possono GetUpperBound determinare se il valore di non è index compreso nei limiti.

Questo metodo è un'operazione O(1).

Vedi anche

Si applica a

GetValue(Int32[])

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

public:
 System::Object ^ GetValue(... cli::array <int> ^ indices);
public object GetValue (params 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.

Restituisce

Object

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

Eccezioni

indices è null.

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

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 metodi e possono determinare se uno degli indici non GetLowerBound GetUpperBound è in limiti.

Questo metodo è un'operazione O(1).

Vedi anche

Si applica a

GetValue(Int64)

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

public:
 System::Object ^ GetValue(long index);
public object? GetValue (long index);
public object GetValue (long index);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (long index);
member this.GetValue : int64 -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 -> obj
Public Function GetValue (index As Long) As Object

Parametri

index
Int64

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

Restituisce

Object

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

Attributi

Eccezioni

L'oggetto Array corrente non ha esattamente una dimensione.

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

Commenti

I GetLowerBound metodi e possono GetUpperBound determinare se il valore di non è index compreso nei limiti.

Questo metodo è un'operazione O(1).

Vedi anche

Si applica a

GetValue(Int64[])

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

public:
 System::Object ^ GetValue(... cli::array <long> ^ indices);
public object? GetValue (params long[] indices);
public object GetValue (params long[] indices);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (params long[] indices);
member this.GetValue : int64[] -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64[] -> obj
Public Function GetValue (ParamArray indices As Long()) As Object

Parametri

indices
Int64[]

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

Restituisce

Object

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

Attributi

Eccezioni

indices è null.

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

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 metodi e possono determinare se uno degli indici non GetLowerBound GetUpperBound è in limiti.

Questo metodo è un'operazione O(1).

Vedi anche

Si applica a

GetValue(Int32, Int32)

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

public:
 System::Object ^ GetValue(int index1, int index2);
public 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.

Restituisce

Object

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

Eccezioni

L'oggetto Array corrente non ha esattamente due dimensioni.

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

Commenti

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

Questo metodo è un'operazione O(1).

Vedi anche

Si applica a

GetValue(Int64, Int64)

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

public:
 System::Object ^ GetValue(long index1, long index2);
public object? GetValue (long index1, long index2);
public object GetValue (long index1, long index2);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (long index1, long index2);
member this.GetValue : int64 * int64 -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 * int64 -> obj
Public Function GetValue (index1 As Long, index2 As Long) As Object

Parametri

index1
Int64

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

index2
Int64

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

Restituisce

Object

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

Attributi

Eccezioni

L'oggetto Array corrente non ha esattamente due dimensioni.

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

Commenti

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

Questo metodo è un'operazione O(1).

Vedi anche

Si applica a

GetValue(Int32, Int32, Int32)

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto Array tridimensionale. 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);
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.

Restituisce

Object

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

Eccezioni

L'oggetto Array corrente non ha esattamente tre dimensioni.

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

Commenti

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

Questo metodo è un'operazione O(1).

Vedi anche

Si applica a

GetValue(Int64, Int64, Int64)

Ottiene il valore in corrispondenza della posizione specificata nell'oggetto Array tridimensionale. 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);
public object GetValue (long index1, long index2, long index3);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (long index1, long index2, long index3);
member this.GetValue : int64 * int64 * int64 -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 * int64 * int64 -> obj
Public Function GetValue (index1 As Long, index2 As Long, index3 As Long) As Object

Parametri

index1
Int64

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

index2
Int64

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

index3
Int64

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

Restituisce

Object

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

Attributi

Eccezioni

L'oggetto Array corrente non ha esattamente tre dimensioni.

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

Commenti

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

Questo metodo è un'operazione O(1).

Vedi anche

Si applica a