Sdílet prostřednictvím


Array.GetValue Metoda

Definice

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

Přetížení

GetValue(Int32)

Získá hodnotu na zadané pozici v jednorozměrné Array. Index je zadán jako 32bitové celé číslo.

GetValue(Int32[])

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

GetValue(Int64)

Získá hodnotu na zadané pozici v jednorozměrné Array. Index je zadán jako 64bitové celé číslo.

GetValue(Int64[])

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

GetValue(Int32, Int32)

Získá hodnotu na zadané pozici v dvojrozměrné Array. Indexy jsou udávány jako 32bitová celá čísla.

GetValue(Int64, Int64)

Získá hodnotu na zadané pozici v dvojrozměrné Array. Indexy jsou udávány jako 64bitová celá čísla.

GetValue(Int32, Int32, Int32)

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

GetValue(Int64, Int64, Int64)

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

Příklady

Následující příklad kódu ukazuje, jak nastavit a získat určitou hodnotu v jednorozměrném nebo vícerozměrném poli.

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

GetValue(Int32)

Získá hodnotu na zadané pozici v jednorozměrné Array. Index je zadán jako 32bitové celé číslo.

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

Parametry

index
Int32

32bitové 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

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

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

Poznámky

GetUpperBound Metody GetLowerBound můžou určit, jestli je hodnota index mimo hranice.

Tato metoda je operace O(1).

Viz také

Platí pro

GetValue(Int32[])

Získá hodnotu na zadané 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);
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

indices je null.

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

Jakýkoli prvek v indices je 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 číslu Array. Všechny prvky v indices poli musí souhrnně určovat pozici požadovaného prvku v multidimenzionální Array.

GetUpperBound Metody GetLowerBound můžou určit, jestli je některý z indexů mimo hranice.

Tato metoda je operace O(1).

Viz také

Platí pro

GetValue(Int64)

Získá hodnotu na zadané pozici v jednorozměrné Array. Index je zadán jako 64bitové celé číslo.

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

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 .

Atributy

Výjimky

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

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

Poznámky

GetUpperBound Metody GetLowerBound můžou určit, jestli je hodnota index mimo hranice.

Tato metoda je operace O(1).

Viz také

Platí pro

GetValue(Int64[])

Získá hodnotu na zadané 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);
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

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.

Atributy

Výjimky

indices je null.

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

Jakýkoli prvek v indices je 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 číslu Array. Všechny prvky v indices poli musí souhrnně určovat pozici požadovaného prvku v multidimenzionální Array.

GetUpperBound Metody GetLowerBound můžou určit, jestli je některý z indexů mimo hranice.

Tato metoda je operace O(1).

Viz také

Platí pro

GetValue(Int32, Int32)

Získá hodnotu na zadané pozici v dvojrozměrné Array. Indexy jsou udávány jako 32bitová celá čísla.

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

Parametry

index1
Int32

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

index2
Int32

32bitové 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

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

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

Poznámky

GetUpperBound Metody GetLowerBound můžou určit, jestli je některý z indexů mimo hranice.

Tato metoda je operace O(1).

Viz také

Platí pro

GetValue(Int64, Int64)

Získá hodnotu na zadané pozici v dvojrozměrné Array. Indexy jsou udávány jako 64bitová celá čísla.

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

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 .

Atributy

Výjimky

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

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

Poznámky

GetUpperBound Metody GetLowerBound můžou určit, jestli je některý z indexů mimo hranice.

Tato metoda je operace O(1).

Viz také

Platí pro

GetValue(Int32, Int32, Int32)

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

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

Parametry

index1
Int32

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

index2
Int32

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

index3
Int32

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

Návraty

Object

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

Výjimky

Proud Array nemá přesně tři rozměry.

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

Poznámky

GetUpperBound Metody GetLowerBound můžou určit, jestli je některý z indexů mimo hranice.

Tato metoda je operace O(1).

Viz také

Platí pro

GetValue(Int64, Int64, Int64)

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

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

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, který chcete získat.

Návraty

Object

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

Atributy

Výjimky

Proud Array nemá přesně tři rozměry.

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

Poznámky

GetUpperBound Metody GetLowerBound můžou určit, jestli je některý z indexů mimo hranice.

Tato metoda je operace O(1).

Viz také

Platí pro