Array.GetValue Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ArgumentException

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

IndexOutOfRangeException

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

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 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: ComVisibleAttribute

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

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: ComVisibleAttribute

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 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

ArgumentException

Array Aktuální 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

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: ComVisibleAttribute

Výjimky

ArgumentException

Array Aktuální 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

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

ArgumentException

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

IndexOutOfRangeException

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: ComVisibleAttribute

Výjimky

ArgumentException

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

ArgumentOutOfRangeException

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

Array.GetValue Metoda

Definice

Přetížení

Příklady

GetValue(Int32)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetValue(Int32[])

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetValue(Int64)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetValue(Int64[])

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetValue(Int32, Int32)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetValue(Int64, Int64)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetValue(Int32, Int32, Int32)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetValue(Int64, Int64, Int64)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

Další materiály