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, Int32, Int32)

 

Veröffentlicht: Oktober 2016

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

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

public object GetValue(
	int index1,
	int index2,
	int index3
)

Parameter

index1
Type: System.Int32

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

index2
Type: System.Int32

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

index3
Type: System.Int32

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

Rückgabewert

Type: System.Object

Der Wert an der angegebenen Position des dreidimensionalen Array.

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

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

*/

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: