Array.GetValue Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Ruft den Wert des angegebenen Elements im aktuellen Array ab.

Überlädt

GetValue(Int32)

Ruft den Wert an der angegebenen Position des eindimensionalen Array ab. Der Index wird als 32-Bit-Ganzzahl angegeben.
GetValue(Int32[])

Ruft den Wert an der angegebenen Position des mehrdimensionalen Array ab. Die Indizes werden als ein Array von 32-Bit-Ganzzahlen angegeben.
GetValue(Int64)

Ruft den Wert an der angegebenen Position des eindimensionalen Array ab. Der Index wird als 64-Bit-Ganzzahl angegeben.
GetValue(Int64[])

Ruft den Wert an der angegebenen Position des mehrdimensionalen Array ab. Die Indizes werden als ein Array von 64-Bit-Ganzzahlen angegeben.
GetValue(Int32, Int32)

Ruft den Wert an der angegebenen Position des zweidimensionalen Array ab. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.
GetValue(Int64, Int64)

Ruft den Wert an der angegebenen Position des zweidimensionalen Array ab. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.
GetValue(Int32, Int32, Int32)

Ruft den Wert an der angegebenen Position des dreidimensionalen Array ab. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.
GetValue(Int64, Int64, Int64)

Ruft den Wert an der angegebenen Position des dreidimensionalen Array ab. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen bestimmten Wert in einem eindimensionalen oder mehrdimensionalen Array festlegen und abrufen.

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)

Ruft den Wert an der angegebenen Position des eindimensionalen Array ab. Der Index wird als 32-Bit-Ganzzahl angegeben.

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

Parameter

index
Int32

Eine 32-Bit-Ganzzahl, die die Position des abzurufenden Array-Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position des eindimensionalen Array.

Ausnahmen

ArgumentException

Das aktuelle Array verfügt nicht über genau eine Dimension.

IndexOutOfRangeException

index liegt außerhalb des Bereichs der gültigen Indizes für das aktuelle Array.

Hinweise

Die GetLowerBound Und GetUpperBound Methoden können bestimmen, ob der Wert index außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Siehe auch

Gilt für

GetValue(Int32[])

Ruft den Wert an der angegebenen Position des mehrdimensionalen Array ab. Die Indizes werden als ein Array von 32-Bit-Ganzzahlen angegeben.

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

Parameter

indices
Int32[]

Ein eindimensionales Array von 32-Bit-Ganzzahlen, die die Indizes darstellen, die die Position des abzurufenden Array-Elements angeben.

Gibt zurück

Object

Der Wert an der angegebenen Position des mehrdimensionalen Array.

Ausnahmen

ArgumentNullException

indices ist null.

ArgumentException

Die Anzahl von Dimensionen im aktuellen Array ist nicht mit der Anzahl von Elementen in indices identisch.

IndexOutOfRangeException

Jedes Element in indices liegt außerhalb des Bereichs der gültigen Indizes für die entsprechende Dimension des aktuellen Array.

Hinweise

Die Anzahl der Elemente in indices muss der Anzahl der Dimensionen in der Array. Alle Elemente im indices Array müssen gemeinsam die Position des gewünschten Elements im mehrdimensionalen ArrayElement angeben.

Die GetLowerBound Methoden GetUpperBound und Methoden können bestimmen, ob eine der Indizes außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Siehe auch

Gilt für

GetValue(Int64)

Ruft den Wert an der angegebenen Position des eindimensionalen Array ab. Der Index wird als 64-Bit-Ganzzahl angegeben.

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

Parameter

index
Int64

Eine 64-Bit-Ganzzahl, die die Position des abzurufenden Array-Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position des eindimensionalen Array.

Attribute
ComVisibleAttribute

Ausnahmen

ArgumentException

Das aktuelle Array verfügt nicht über genau eine Dimension.

ArgumentOutOfRangeException

index liegt außerhalb des Bereichs der gültigen Indizes für das aktuelle Array.

Hinweise

Die GetLowerBound Und GetUpperBound Methoden können bestimmen, ob der Wert index außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Siehe auch

Gilt für

GetValue(Int64[])

Ruft den Wert an der angegebenen Position des mehrdimensionalen Array ab. Die Indizes werden als ein Array von 64-Bit-Ganzzahlen angegeben.

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

Parameter

indices
Int64[]

Ein eindimensionales Array von 64-Bit-Ganzzahlen, das die Indizes darstellt, die die Position des abzurufenden Array-Elements angeben.

Gibt zurück

Object

Der Wert an der angegebenen Position des mehrdimensionalen Array.

Attribute
ComVisibleAttribute

Ausnahmen

ArgumentNullException

indices ist null.

ArgumentException

Die Anzahl von Dimensionen im aktuellen Array ist nicht mit der Anzahl von Elementen in indices identisch.

ArgumentOutOfRangeException

Jedes Element in indices liegt außerhalb des Bereichs der gültigen Indizes für die entsprechende Dimension des aktuellen Array.

Hinweise

Die Anzahl der Elemente in indices muss der Anzahl der Dimensionen in der Array. Alle Elemente im indices Array müssen gemeinsam die Position des gewünschten Elements im mehrdimensionalen ArrayElement angeben.

Die GetLowerBound Methoden GetUpperBound und Methoden können bestimmen, ob eine der Indizes außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Siehe auch

Gilt für

GetValue(Int32, Int32)

Ruft den Wert an der angegebenen Position des zweidimensionalen Array ab. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.

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

Parameter

index1
Int32

Eine 32-Bit-Ganzzahl, die den Index für die erste Dimension des abzurufenden Array-Elements darstellt.

index2
Int32

Eine 32-Bit-Ganzzahl, die den Index für die zweite Dimension des abzurufenden Array-Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position des zweidimensionalen Array.

Ausnahmen

ArgumentException

Das aktuelle Array verfügt nicht über genau zwei Dimensionen.

IndexOutOfRangeException

Entweder index1 oder index2 liegt außerhalb des Bereichs der gültigen Indizes für die entsprechende Dimension des aktuellen Array.

Hinweise

Die GetLowerBound Methoden GetUpperBound und Methoden können bestimmen, ob eine der Indizes außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Siehe auch

Gilt für

GetValue(Int64, Int64)

Ruft den Wert an der angegebenen Position des zweidimensionalen Array ab. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.

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

Parameter

index1
Int64

Eine 64-Bit-Ganzzahl, die den Index für die erste Dimension des abzurufenden Array-Elements darstellt.

index2
Int64

Eine 64-Bit-Ganzzahl, die den Index für die zweite Dimension des abzurufenden Array-Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position des zweidimensionalen Array.

Attribute
ComVisibleAttribute

Ausnahmen

ArgumentException

Das aktuelle Array verfügt nicht über genau zwei Dimensionen.

ArgumentOutOfRangeException

Entweder index1 oder index2 liegt außerhalb des Bereichs der gültigen Indizes für die entsprechende Dimension des aktuellen Array.

Hinweise

Die GetLowerBound Methoden GetUpperBound und Methoden können bestimmen, ob eine der Indizes außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Siehe auch

Gilt für

GetValue(Int32, Int32, Int32)

Ruft den Wert an der angegebenen Position des dreidimensionalen Array ab. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.

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

Parameter

index1
Int32

Eine 32-Bit-Ganzzahl, die den Index für die erste Dimension des abzurufenden Array-Elements darstellt.

index2
Int32

Eine 32-Bit-Ganzzahl, die den Index für die zweite Dimension des abzurufenden Array-Elements darstellt.

index3
Int32

Eine 32-Bit-Ganzzahl, die den Index für die dritte Dimension des abzurufenden Array-Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position des dreidimensionalen Array.

Ausnahmen

ArgumentException

Das aktuelle Array verfügt nicht über genau drei Dimensionen.

IndexOutOfRangeException

Entweder index1, index2 oder index3 liegt außerhalb des Bereichs gültiger Indizes für die entsprechende Dimension des aktuellen Array.

Hinweise

Die GetLowerBound Methoden GetUpperBound und Methoden können bestimmen, ob eine der Indizes außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Siehe auch

Gilt für

GetValue(Int64, Int64, Int64)

Ruft den Wert an der angegebenen Position des dreidimensionalen Array ab. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.

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

Parameter

index1
Int64

Eine 64-Bit-Ganzzahl, die den Index für die erste Dimension des abzurufenden Array-Elements darstellt.

index2
Int64

Eine 64-Bit-Ganzzahl, die den Index für die zweite Dimension des abzurufenden Array-Elements darstellt.

index3
Int64

Eine 64-Bit-Ganzzahl, die den Index für die dritte Dimension des abzurufenden Array-Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position des dreidimensionalen Array.

Attribute
ComVisibleAttribute

Ausnahmen

ArgumentException

Das aktuelle Array verfügt nicht über genau drei Dimensionen.

ArgumentOutOfRangeException

Entweder index1, index2 oder index3 liegt außerhalb des Bereichs gültiger Indizes für die entsprechende Dimension des aktuellen Array.

Hinweise

Die GetLowerBound Methoden GetUpperBound können bestimmen, ob eine der Indizes nicht an Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Siehe auch

Gilt für