(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Array.SetValue-Methode (Object, Int64, Int64, Int64)

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

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

[ComVisibleAttribute(false)]
public void SetValue(
	Object value,
	long index1,
	long index2,
	long index3
)

Parameter

value
Typ: System.Object
Der neue Wert für das angegebene Element.
index1
Typ: System.Int64
Eine 64-Bit-Ganzzahl, die den Index für die erste Dimension des festzulegenden Array-Elements darstellt.
index2
Typ: System.Int64
Eine 64-Bit-Ganzzahl, die den Index für die zweite Dimension des festzulegenden Array-Elements darstellt.
index3
Typ: System.Int64
Eine 64-Bit-Ganzzahl, die den Index für die dritte Dimension des festzulegenden Array-Elements darstellt.

AusnahmeBedingung
ArgumentException

Das aktuelle Array hat nicht genau drei Dimensionen.

InvalidCastException

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

ArgumentOutOfRangeException

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

Mit der GetLowerBound-Methode und der GetUpperBound-Methode kann bestimmt werden, ob einer der Indizes außerhalb der zulässigen Grenzen liegt.

Weitere Informationen über Konvertierungen finden Sie unter Convert.

Diese Methode ist eine O(1)-Operation.

HinweisHinweis

Wenn SetValue verwendet wird, um einem Element eines Arrays von Werttypen null zuzuweisen, 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 ein spezifischer Wert in einem eindimensionalen oder mehrdimensionalen 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

*/



.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft