Array.GetValue Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Získá hodnotu zadaného prvku v aktuálním Array.

Přetížení

Name	Description
GetValue(Int32)	Získá hodnotu na určené pozici v jednorozměrné Array. Index se zadává jako 32bitové celé číslo.
GetValue(Int32[])	Získá hodnotu na určené pozici v multidimenzionální Array. Indexy se zadají jako pole 32bitových celých čísel.
GetValue(Int64)	Získá hodnotu na určené pozici v jednorozměrné Array. Index se zadává jako 64bitové celé číslo.
GetValue(Int64[])	Získá hodnotu na určené pozici v multidimenzionální Array. Indexy se zadají jako pole 64bitových celých čísel.
GetValue(Int32, Int32)	Získá hodnotu na určené pozici v dvojrozměrné Array. Indexy se zadají jako 32bitová celá čísla.
GetValue(Int64, Int64)	Získá hodnotu na určené pozici v dvojrozměrné Array. Indexy se zadají jako 64bitová celá čísla.
GetValue(Int32, Int32, Int32)	Získá hodnotu na zadané pozici v trojrozměrném Arrayobjektu . Indexy se zadají jako 32bitová celá čísla.
GetValue(Int64, Int64, Int64)	Získá hodnotu na zadané pozici v trojrozměrném Arrayobjektu . Indexy se zadají jako 64bitová celá čísla.

Příklady

Následující příklad kódu ukazuje, jak nastavit a získat konkrétní hodnotu v jednorozměrném nebo multidimenzionálním poli.

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)

Zdroj:

Array.cs

Získá hodnotu na určené pozici v jednorozměrné Array. Index se zadává jako 32bitové celé číslo.

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

public object? GetValue(int index);

member this.GetValue : int -> obj

Public Function GetValue (index As Integer) As Object

Parametry

index

Int32

32bitové celé číslo, které představuje pozici Array prvku, který chcete získat.

Návraty

Object

Hodnota na zadané pozici v jednorozměrném Arrayobjektu .

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně jednu dimenzi.

IndexOutOfRangeException

index je mimo rozsah platných indexů pro aktuální Array.

Poznámky

GetLowerBound Metody GetUpperBound mohou určit, zda je hodnota index mimo hranice.

Tato metoda je operace O(1).

Viz také

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

GetValue(Int32[])

Zdroj:

Array.cs

Získá hodnotu na určené pozici v multidimenzionální Array. Indexy se zadají jako pole 32bitových celých čísel.

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

Parametry

indices

Int32[]

Jednorozměrné pole 32bitových celých čísel, které představují indexy určující pozici Array prvku, který se má získat.

Návraty

Object

Hodnota na zadané pozici v multidimenzionální Array.

Výjimky

ArgumentNullException

indices je null.

ArgumentException

Počet dimenzí v aktuálním proudu Array se nerovná počtu prvků v indices.

IndexOutOfRangeException

Jakýkoli prvek je indices mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

Počet prvků v indices musí být roven počtu dimenzí v Arraysadě . Všechny prvky v indices poli musí souhrnně určit pozici požadovaného prvku v multidimenzionální Array.

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Tato metoda je operace O(1).

Viz také

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

GetValue(Int64)

Zdroj:

Array.cs

Získá hodnotu na určené pozici v jednorozměrné Array. Index se zadává jako 64bitové celé číslo.

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

public object? GetValue(long index);

member this.GetValue : int64 -> obj

Public Function GetValue (index As Long) As Object

Parametry

index

Int64

64bitové celé číslo, které představuje pozici Array prvku, který se má získat.

Návraty

Object

Hodnota na zadané pozici v jednorozměrném Arrayobjektu .

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně jednu dimenzi.

ArgumentOutOfRangeException

index je mimo rozsah platných indexů pro aktuální Array.

Poznámky

GetLowerBound Metody GetUpperBound mohou určit, zda je hodnota index mimo hranice.

Tato metoda je operace O(1).

Viz také

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

GetValue(Int64[])

Zdroj:

Array.cs

Získá hodnotu na určené pozici v multidimenzionální Array. Indexy se zadají jako pole 64bitových celých čísel.

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

Parametry

indices

Int64[]

Jednorozměrné pole 64bitových celých čísel, které představují indexy určující pozici Array prvku, který se má získat.

Návraty

Object

Hodnota na zadané pozici v multidimenzionální Array.

Výjimky

ArgumentNullException

indices je null.

ArgumentException

Počet dimenzí v aktuálním proudu Array se nerovná počtu prvků v indices.

ArgumentOutOfRangeException

Jakýkoli prvek je indices mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

Počet prvků v indices musí být roven počtu dimenzí v Arraysadě . Všechny prvky v indices poli musí souhrnně určit pozici požadovaného prvku v multidimenzionální Array.

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Tato metoda je operace O(1).

Viz také

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

GetValue(Int32, Int32)

Zdroj:

Array.cs

Získá hodnotu na určené pozici v dvojrozměrné Array. Indexy se zadají jako 32bitová celá čísla.

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

Parametry

index1

Int32

32bitové celé číslo, které představuje index Array první dimenze prvku, který chcete získat.

index2

Int32

32bitové celé číslo, které představuje index Array druhé dimenze prvku, který chcete získat.

Návraty

Object

Hodnota na zadané pozici v dvojrozměrném Arrayobjektu .

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně dvě dimenze.

IndexOutOfRangeException

Buď index1 nebo index2 je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Tato metoda je operace O(1).

Viz také

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

GetValue(Int64, Int64)

Zdroj:

Array.cs

Získá hodnotu na určené pozici v dvojrozměrné Array. Indexy se zadají jako 64bitová celá čísla.

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

Parametry

index1

Int64

64bitové celé číslo, které představuje index Array první dimenze prvku, který chcete získat.

index2

Int64

64bitové celé číslo, které představuje index Array druhé dimenze prvku, který se má získat.

Návraty

Object

Hodnota na zadané pozici v dvojrozměrném Arrayobjektu .

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně dvě dimenze.

ArgumentOutOfRangeException

Buď index1 nebo index2 je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Tato metoda je operace O(1).

Viz také

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

GetValue(Int32, Int32, Int32)

Zdroj:

Array.cs

Získá hodnotu na zadané pozici v trojrozměrném Arrayobjektu . Indexy se zadají jako 32bitová celá čísla.

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

Parametry

index1

Int32

32bitové celé číslo, které představuje index Array první dimenze prvku, který chcete získat.

index2

Int32

32bitové celé číslo, které představuje index Array druhé dimenze prvku, který chcete získat.

index3

Int32

32bitové celé číslo, které představuje index Array třetí dimenze prvku, který chcete získat.

Návraty

Object

Hodnota na zadané pozici v trojrozměrném Arrayobjektu .

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně tři rozměry.

IndexOutOfRangeException

index1 nebo index2index3 je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Tato metoda je operace O(1).

Viz také

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

GetValue(Int64, Int64, Int64)

Zdroj:

Array.cs

Získá hodnotu na zadané pozici v trojrozměrném Arrayobjektu . Indexy se zadají jako 64bitová celá čísla.

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

Parametry

index1

Int64

64bitové celé číslo, které představuje index Array první dimenze prvku, který chcete získat.

index2

Int64

64bitové celé číslo, které představuje index Array druhé dimenze prvku, který se má získat.

index3

Int64

64bitové celé číslo, které představuje index Array třetí dimenze prvku k získání.

Návraty

Object

Hodnota na zadané pozici v trojrozměrném Arrayobjektu .

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně tři rozměry.

ArgumentOutOfRangeException

index1 nebo index2index3 je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Tato metoda je operace O(1).

Viz také

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