Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Array.GetValue-Methode: (Int32[])

 

Veröffentlicht: Oktober 2016

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

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public object GetValue(
	params int[] indices
)

Parameter

indices
Type: System.Int32[]

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

Rückgabewert

Type: System.Object

Der Wert an der angegebenen Position des mehrdimensionalen Array.

Exception Condition
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.

Die Anzahl der Elemente im indices muss gleich der Anzahl der Dimensionen in der Array. Alle Elemente in der indices Array geben muss zusammen die Position des gewünschten Elements des mehrdimensionalen Array.

Die GetLowerBound und GetUpperBound Methoden können bestimmen, ob einer der Indizes außerhalb des gültigen Bereichs.

Diese Methode ist ein o(1)-Vorgang.

Im folgenden Codebeispiel wird veranschaulicht, wie zum Festlegen und Abrufen eines bestimmten Werts in ein eindimensionales oder mehrdimensionales Array.

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

*/

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: