Questa documentazione è stata archiviata e non viene gestita.

Metodo Array.GetValue (Int64[])

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

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

[ComVisibleAttribute(false)] 
public Object GetValue (
	params long[] indices
)
/** @attribute ComVisibleAttribute(false) */ 
public Object GetValue (
	long[] indices
)
ComVisibleAttribute(false) 
public function GetValue (
	... indices : long[]
) : Object
Non applicabile.

Parametri

indices

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

Valore restituito

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

Tipo di eccezioneCondizione

ArgumentNullException

indices è riferimento null (Nothing in Visual Basic).

ArgumentException

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

ArgumentOutOfRangeException

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

È necessario che il numero di elementi in indices sia uguale al numero di dimensioni nell'oggetto Array. Tutti gli elementi nella matrice indices devono specificare collettivamente la posizione dell'elemento desiderato nell'oggetto Array multidimensionale.

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

Questo metodo costituisce un'operazione O(1).

Nell'esempio di codice riportato di seguito viene mostrato 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

*/


import System.*;

public class SamplesArray
{
    public static void main(String[] args)
    {
        // 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[] = { 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));
    } //main 
} //SamplesArray
/* 
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

*/

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:
Mostra: