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.SetValue-Methode: (Object, Int32, Int32, Int32)

 

Veröffentlicht: Oktober 2016

Legt einen Wert auf das Element an der angegebenen Position im dreidimensionalen Array fest. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.

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

public void SetValue(
	object value,
	int index1,
	int index2,
	int index3
)

Parameter

value
Type: System.Object

Der neue Wert für das angegebene Element.

index1
Type: System.Int32

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

index2
Type: System.Int32

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

index3
Type: System.Int32

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

Exception Condition
ArgumentException

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

InvalidCastException

value kann nicht in den Elementtyp des aktuellen Array umgewandelt werden.

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.

Weitere Informationen über Konvertierungen finden Sie unter Convert.

Diese Methode ist ein o(1)-Vorgang.

System_CAPS_noteHinweis

Wenn SetValue zugewiesen null auf ein Element eines Arrays von Werttypen, werden alle Felder des Elements mit 0 (null) initialisiert. Der Wert des Elements ist kein null-Verweis, und kann nicht durch Suchen nach einem null-Verweis gefunden werden.

Im folgenden Codebeispiel wird veranschaulicht, wie festgelegt und einen bestimmten Wert in ein eindimensionales oder mehrdimensionales Array 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

*/

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