Array.GetValue Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Ruft den Wert des angegebenen Elements in der aktuellen Arrayab.

Überlädt

Name	Beschreibung
GetValue(Int32)	Ruft den Wert an der angegebenen Position in der eindimensionalen Array. Der Index wird als 32-Bit-Ganzzahl angegeben.
GetValue(Int32[])	Ruft den Wert an der angegebenen Position in der multidimensionalen Array. Die Indizes werden als Array mit 32-Bit-Ganzzahlen angegeben.
GetValue(Int64)	Ruft den Wert an der angegebenen Position in der eindimensionalen Array. Der Index wird als 64-Bit-Ganzzahl angegeben.
GetValue(Int64[])	Ruft den Wert an der angegebenen Position in der multidimensionalen Array. Die Indizes werden als Array mit 64-Bit-Ganzzahlen angegeben.
GetValue(Int32, Int32)	Ruft den Wert an der angegebenen Position in der zweidimensionalen Array. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.
GetValue(Int64, Int64)	Ruft den Wert an der angegebenen Position in der zweidimensionalen Array. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.
GetValue(Int32, Int32, Int32)	Ruft den Wert an der angegebenen Position in der dreidimensionalen Array. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.
GetValue(Int64, Int64, Int64)	Ruft den Wert an der angegebenen Position in der dreidimensionalen Array. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein bestimmter Wert in einem eindimensionalen oder multidimensionalen Array festgelegt und abgerufen wird.

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)

Quelle:

Array.cs

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

public:
 System::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 Array abzurufenden Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position in der eindimensionalen Array.

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau eine Dimension.

IndexOutOfRangeException

index liegt außerhalb des Bereichs gültiger Indizes für den aktuellen Array.

Hinweise

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

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

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

GetValue(Int32[])

Quelle:

Array.cs

Ruft den Wert an der angegebenen Position in der multidimensionalen Array. Die Indizes werden als Array mit 32-Bit-Ganzzahlen angegeben.

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

Parameter

indices

Int32[]

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

Gibt zurück

Object

Der Wert an der angegebenen Position in der multidimensionalen Array.

Ausnahmen

ArgumentNullException

indices ist null.

ArgumentException

Die Anzahl der Dimensionen im Aktuellen Array entspricht nicht der Anzahl der Elemente in indices.

IndexOutOfRangeException

Jedes Element befindet indices sich außerhalb des Bereichs gültiger Indizes für die entsprechende Dimension des aktuellen ArrayElements.

Hinweise

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

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

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

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

GetValue(Int64)

Quelle:

Array.cs

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

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

public object? GetValue(long index);

member this.GetValue : int64 -> obj

Public Function GetValue (index As Long) As Object

Parameter

index

Int64

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

Gibt zurück

Object

Der Wert an der angegebenen Position in der eindimensionalen Array.

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau eine Dimension.

ArgumentOutOfRangeException

index liegt außerhalb des Bereichs gültiger Indizes für den aktuellen Array.

Hinweise

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

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

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

GetValue(Int64[])

Quelle:

Array.cs

Ruft den Wert an der angegebenen Position in der multidimensionalen Array. Die Indizes werden als Array mit 64-Bit-Ganzzahlen angegeben.

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

Parameter

indices

Int64[]

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

Gibt zurück

Object

Der Wert an der angegebenen Position in der multidimensionalen Array.

Ausnahmen

ArgumentNullException

indices ist null.

ArgumentException

Die Anzahl der Dimensionen im Aktuellen Array entspricht nicht der Anzahl der Elemente in indices.

ArgumentOutOfRangeException

Jedes Element befindet indices sich außerhalb des Bereichs gültiger Indizes für die entsprechende Dimension des aktuellen ArrayElements.

Hinweise

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

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

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

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

GetValue(Int32, Int32)

Quelle:

Array.cs

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

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

Parameter

index1

Int32

Eine 32-Bit-Ganzzahl, die den Index der ersten Dimension des Array abzurufenden Elements darstellt.

index2

Int32

Eine 32-Bit-Ganzzahl, die den index der zweiten Dimension des Array abzurufenden Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position in der zweidimensionalen Array.

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau zwei Dimensionen.

IndexOutOfRangeException

Entweder index1 oder index2 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 außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

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

GetValue(Int64, Int64)

Quelle:

Array.cs

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

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

Parameter

index1

Int64

Eine 64-Bit-Ganzzahl, die den Index der ersten Dimension des Array abzurufenden Elements darstellt.

index2

Int64

Eine 64-Bit-Ganzzahl, die den index der zweiten Dimension des Array abzurufenden Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position in der zweidimensionalen Array.

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau zwei Dimensionen.

ArgumentOutOfRangeException

Entweder index1 oder index2 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 außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

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

GetValue(Int32, Int32, Int32)

Quelle:

Array.cs

Ruft den Wert an der angegebenen Position in der dreidimensionalen Array. 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);

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 der ersten Dimension des Array abzurufenden Elements darstellt.

index2

Int32

Eine 32-Bit-Ganzzahl, die den index der zweiten Dimension des Array abzurufenden Elements darstellt.

index3

Int32

Eine 32-Bit-Ganzzahl, die den index der dritten Dimension des Array abzurufenden Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position in der dreidimensionalen Array.

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau drei Dimensionen.

IndexOutOfRangeException

index1 oder index2index3 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 außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

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

GetValue(Int64, Int64, Int64)

Quelle:

Array.cs

Ruft den Wert an der angegebenen Position in der dreidimensionalen Array. 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);

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 der ersten Dimension des Array abzurufenden Elements darstellt.

index2

Int64

Eine 64-Bit-Ganzzahl, die den index der zweiten Dimension des Array abzurufenden Elements darstellt.

index3

Int64

Eine 64-Bit-Ganzzahl, die den Index der dritten Dimension des Array abzurufenden Elements darstellt.

Gibt zurück

Object

Der Wert an der angegebenen Position in der dreidimensionalen Array.

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau drei Dimensionen.

ArgumentOutOfRangeException

index1 oder index2index3 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 außerhalb der Grenzen liegt.

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

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