Array.SetValue Methode

Definition

Namespace:

System

Assembly:

mscorlib.dll

Legt das angegebene Element im aktuellen Array auf den angegebenen Wert fest.

Überlädt

Name	Beschreibung
SetValue(Object, Int32)	Legt einen Wert auf das Element an der angegebenen Position in der eindimensionalen Array. Der Index wird als 32-Bit-Ganzzahl angegeben.
SetValue(Object, Int32[])	Legt einen Wert auf das Element an der angegebenen Position im mehrdimensionalen ArrayFest. Die Indizes werden als Array mit 32-Bit-Ganzzahlen angegeben.
SetValue(Object, Int64)	Legt einen Wert auf das Element an der angegebenen Position in der eindimensionalen Array. Der Index wird als 64-Bit-Ganzzahl angegeben.
SetValue(Object, Int64[])	Legt einen Wert auf das Element an der angegebenen Position im mehrdimensionalen ArrayFest. Die Indizes werden als Array mit 64-Bit-Ganzzahlen angegeben.
SetValue(Object, Int32, Int32)	Legt einen Wert auf das Element an der angegebenen Position in der zweidimensionalen Array. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.
SetValue(Object, Int64, Int64)	Legt einen Wert auf das Element an der angegebenen Position in der zweidimensionalen Array. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.
SetValue(Object, Int32, Int32, Int32)	Legt einen Wert auf das Element an der angegebenen Position in der dreidimensionalen Array. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.
SetValue(Object, Int64, Int64, Int64)	Legt einen Wert auf das Element 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

SetValue(Object, Int32)

Legt einen Wert auf das Element an der angegebenen Position in der eindimensionalen Array. Der Index wird als 32-Bit-Ganzzahl angegeben.

public:
 void SetValue(System::Object ^ value, int index);

public void SetValue(object value, int index);

member this.SetValue : obj * int -> unit

Public Sub SetValue (value As Object, index As Integer)

Parameter

value

Object

Der neue Wert für das angegebene Element.

index

Int32

Eine 32-Bit-Ganzzahl, die die Position des Array festzulegenden Elements darstellt.

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau eine Dimension.

InvalidCastException

value kann nicht in den Elementtyp des aktuellen ArrayTyps umgestellt werden.

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.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Diese Methode ist ein O(1)-Vorgang.

Note

Wird SetValue verwendet, um einem Element eines Arrays von Werttypen zuzuweisen null , werden alle Felder des Elements auf Null initialisiert. Der Wert des Elements ist kein Nullverweis und kann nicht gefunden werden, indem nach einem Nullverweis gesucht wird.

Weitere Informationen

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int32[])

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

public:
 void SetValue(System::Object ^ value, ... cli::array <int> ^ indices);

public void SetValue(object value, params int[] indices);

member this.SetValue : obj * int[] -> unit

Public Sub SetValue (value As Object, ParamArray indices As Integer())

Parameter

value

Object

Der neue Wert für das angegebene Element.

indices

Int32[]

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

Ausnahmen

ArgumentNullException

indices ist null.

ArgumentException

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

InvalidCastException

value kann nicht in den Elementtyp des aktuellen ArrayTyps umgestellt werden.

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 Methoden und GetUpperBound Methoden GetLowerBound können bestimmen, ob eine der Werte im indices Array außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Diese Methode ist ein O(1)-Vorgang.

Note

Wird SetValue verwendet, um einem Element eines Arrays von Werttypen zuzuweisen null , werden alle Felder des Elements auf Null initialisiert. Der Wert des Elements ist kein Nullverweis und kann nicht gefunden werden, indem nach einem Nullverweis gesucht wird.

Weitere Informationen

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int64)

Legt einen Wert auf das Element an der angegebenen Position in der eindimensionalen Array. Der Index wird als 64-Bit-Ganzzahl angegeben.

public:
 void SetValue(System::Object ^ value, long index);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, long index);

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 -> unit

Public Sub SetValue (value As Object, index As Long)

Parameter

value

Object

Der neue Wert für das angegebene Element.

index

Int64

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

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau eine Dimension.

InvalidCastException

value kann nicht in den Elementtyp des aktuellen ArrayTyps umgestellt werden.

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.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Diese Methode ist ein O(1)-Vorgang.

Note

Wird SetValue verwendet, um einem Element eines Arrays von Werttypen zuzuweisen null , werden alle Felder des Elements auf Null initialisiert. Der Wert des Elements ist kein Nullverweis und kann nicht gefunden werden, indem nach einem Nullverweis gesucht wird.

Weitere Informationen

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int64[])

Legt einen Wert auf das Element an der angegebenen Position im mehrdimensionalen ArrayFest. Die Indizes werden als Array mit 64-Bit-Ganzzahlen angegeben.

public:
 void SetValue(System::Object ^ value, ... cli::array <long> ^ indices);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, params long[] indices);

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64[] -> unit

Public Sub SetValue (value As Object, ParamArray indices As Long())

Parameter

value

Object

Der neue Wert für das angegebene Element.

indices

Int64[]

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

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentNullException

indices ist null.

ArgumentException

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

InvalidCastException

value kann nicht in den Elementtyp des aktuellen ArrayTyps umgestellt werden.

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 Methoden und GetUpperBound Methoden GetLowerBound können bestimmen, ob eine der Werte im indices Array außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Diese Methode ist ein O(1)-Vorgang.

Note

Wird SetValue verwendet, um einem Element eines Arrays von Werttypen zuzuweisen null , werden alle Felder des Elements auf Null initialisiert. Der Wert des Elements ist kein Nullverweis und kann nicht gefunden werden, indem nach einem Nullverweis gesucht wird.

Weitere Informationen

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int32, Int32)

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

public:
 void SetValue(System::Object ^ value, int index1, int index2);

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

member this.SetValue : obj * int * int -> unit

Public Sub SetValue (value As Object, index1 As Integer, index2 As Integer)

Parameter

value

Object

Der neue Wert für das angegebene Element.

index1

Int32

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

index2

Int32

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

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau zwei Dimensionen.

InvalidCastException

value kann nicht in den Elementtyp des aktuellen ArrayTyps umgestellt werden.

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.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Diese Methode ist ein O(1)-Vorgang.

Note

Wird SetValue verwendet, um einem Element eines Arrays von Werttypen zuzuweisen null , werden alle Felder des Elements auf Null initialisiert. Der Wert des Elements ist kein Nullverweis und kann nicht gefunden werden, indem nach einem Nullverweis gesucht wird.

Weitere Informationen

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int64, Int64)

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

public:
 void SetValue(System::Object ^ value, long index1, long index2);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, long index1, long index2);

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 * int64 -> unit

Public Sub SetValue (value As Object, index1 As Long, index2 As Long)

Parameter

value

Object

Der neue Wert für das angegebene Element.

index1

Int64

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

index2

Int64

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

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau zwei Dimensionen.

InvalidCastException

value kann nicht in den Elementtyp des aktuellen ArrayTyps umgestellt werden.

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.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Diese Methode ist ein O(1)-Vorgang.

Note

Wird SetValue verwendet, um einem Element eines Arrays von Werttypen zuzuweisen null , werden alle Felder des Elements auf Null initialisiert. Der Wert des Elements ist kein Nullverweis und kann nicht gefunden werden, indem nach einem Nullverweis gesucht wird.

Weitere Informationen

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int32, Int32, Int32)

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

public:
 void SetValue(System::Object ^ value, int index1, int index2, int index3);

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

member this.SetValue : obj * int * int * int -> unit

Public Sub SetValue (value As Object, index1 As Integer, index2 As Integer, index3 As Integer)

Parameter

value

Object

Der neue Wert für das angegebene Element.

index1

Int32

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

index2

Int32

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

index3

Int32

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

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau drei Dimensionen.

InvalidCastException

value kann nicht in den Elementtyp des aktuellen ArrayTyps umgestellt werden.

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.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Diese Methode ist ein O(1)-Vorgang.

Note

Wird SetValue verwendet, um einem Element eines Arrays von Werttypen zuzuweisen null , werden alle Felder des Elements auf Null initialisiert. Der Wert des Elements ist kein Nullverweis und kann nicht gefunden werden, indem nach einem Nullverweis gesucht wird.

Weitere Informationen

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int64, Int64, Int64)

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

public:
 void SetValue(System::Object ^ value, long index1, long index2, long index3);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, long index1, long index2, long index3);

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 * int64 * int64 -> unit

Public Sub SetValue (value As Object, index1 As Long, index2 As Long, index3 As Long)

Parameter

value

Object

Der neue Wert für das angegebene Element.

index1

Int64

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

index2

Int64

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

index3

Int64

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

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentException

Der Aktuelle Array hat nicht genau drei Dimensionen.

InvalidCastException

value kann nicht in den Elementtyp des aktuellen ArrayTyps umgestellt werden.

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.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Diese Methode ist ein O(1)-Vorgang.

Note

Wird SetValue verwendet, um einem Element eines Arrays von Werttypen zuzuweisen null , werden alle Felder des Elements auf Null initialisiert. Der Wert des Elements ist kein Nullverweis und kann nicht gefunden werden, indem nach einem Nullverweis gesucht wird.

Weitere Informationen

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue