Array.SetValue Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Überlädt

SetValue(Object, Int32)	Legt das Element an der angegebenen Position des eindimensionalen Array auf einen Wert fest. Der Index wird als 32-Bit-Ganzzahl angegeben.
SetValue(Object, Int32[])	Legt das Element an der angegebenen Position des mehrdimensionalen Array auf einen Wert fest. Die Indizes werden als ein Array von 32-Bit-Ganzzahlen angegeben.
SetValue(Object, Int64[])	Legt das Element an der angegebenen Position des mehrdimensionalen Array auf einen Wert fest. Die Indizes werden als ein Array von 64-Bit-Ganzzahlen angegeben.
SetValue(Object, Int32, Int32)	Legt das Element an der angegebenen Position des zweidimensionalen Array auf einen Wert fest. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.
SetValue(Object, Int64, Int64)	Legt das Element an der angegebenen Position des zweidimensionalen Array auf einen Wert fest. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.
SetValue(Object, Int32, Int32, Int32)	Legt einen Wert auf das Element an der angegebenen Position im dreidimensionalen Array fest. Die Indizes werden als 32-Bit-Ganzzahlen angegeben.
SetValue(Object, Int64, Int64, Int64)	Legt einen Wert auf das Element an der angegebenen Position im dreidimensionalen Array fest. Die Indizes werden als 64-Bit-Ganzzahlen angegeben.
SetValue(Object, Int64)	Legt das Element an der angegebenen Position des eindimensionalen Array auf einen Wert fest. Der Index wird als 64-Bit-Ganzzahl angegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein bestimmter Wert in einem eindimensionalen oder mehrdimensionalen Array festgelegt und abgerufen wird.

using namespace System;
int main()
{
   
   // Creates and initializes a one-dimensional array.
   array<String^>^myArr1 = gcnew array<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.
   array<String^, 2>^myArr2 = gcnew array<String^,2>(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.
   array<String^, 3>^myArr3 = gcnew array<String^,3>(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.
   array<String^, 7>^myArr7 = gcnew array<String^,7>(5,5,5,5,5,5,5);
   
   // Sets the element at index 1,2,3,0,1,2,3.
   array<Int32>^myIndices = {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

*/

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)

Quelle:: Array.cs

Quelle:: Array.cs

Quelle:: Array.cs

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

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

public void SetValue (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 festzulegenden Array-Elements darstellt.

Ausnahmen

ArgumentException

Das aktuelle Array verfügt nicht über genau eine Dimension.

InvalidCastException

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

IndexOutOfRangeException

index liegt außerhalb des Bereichs der gültigen Indizes für das aktuelle Array.

Hinweise

Die GetLowerBound Methoden und GetUpperBound können bestimmen, ob der Wert von index außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Hinweis

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

Weitere Informationen

Gilt für:

SetValue(Object, Int32[])

Quelle:: Array.cs

Quelle:: Array.cs

Quelle:: Array.cs

Legt das Element an der angegebenen Position des mehrdimensionalen Array auf einen Wert fest. Die Indizes werden als ein Array von 32-Bit-Ganzzahlen angegeben.

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

public void SetValue (object value, params 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 von 32-Bit-Ganzzahlen, das die Indizes darstellt, die die Position des festzulegenden Elements angeben.

Ausnahmen

ArgumentNullException

indices ist null.

ArgumentException

Die Anzahl von Dimensionen im aktuellen Array ist nicht mit der Anzahl von Elementen in indices identisch.

InvalidCastException

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

IndexOutOfRangeException

Jedes Element in indices liegt außerhalb des Bereichs der gültigen Indizes für die entsprechende Dimension des aktuellen Array.

Hinweise

Die Anzahl der Elemente in indices muss der Anzahl von Dimensionen in entsprechen Array. Alle Elemente im indices Array müssen zusammen die Position des gewünschten Elements im mehrdimensionalen Arrayangeben.

Die GetLowerBound Methoden und GetUpperBound können bestimmen, ob einer der Werte im indices Array außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Hinweis

Weitere Informationen

Gilt für:

SetValue(Object, Int64[])

Quelle:: Array.cs

Quelle:: Array.cs

Quelle:: Array.cs

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

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

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

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

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

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

[<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 von 64-Bit-Ganzzahlen, das die Indizes darstellt, die die Position des festzulegenden Elements angeben.

Attribute: ComVisibleAttribute

Ausnahmen

ArgumentNullException

indices ist null.

ArgumentException

Die Anzahl von Dimensionen im aktuellen Array ist nicht mit der Anzahl von Elementen in indices identisch.

InvalidCastException

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

ArgumentOutOfRangeException

Jedes Element in indices liegt außerhalb des Bereichs der gültigen Indizes für die entsprechende Dimension des aktuellen Array.

Hinweise

Die GetLowerBound Methoden und GetUpperBound können bestimmen, ob einer der Werte im indices Array außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Hinweis

Weitere Informationen

Gilt für:

SetValue(Object, Int32, Int32)

Quelle:: Array.cs

Quelle:: Array.cs

Quelle:: Array.cs

Legt das Element an der angegebenen Position des zweidimensionalen Array auf einen Wert fest. 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);

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 für die erste Dimension des festzulegenden Array-Elements darstellt.

index2: Int32

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

Ausnahmen

ArgumentException

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

InvalidCastException

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

IndexOutOfRangeException

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

Hinweise

Die GetLowerBound Methoden und GetUpperBound können bestimmen, ob einer der Indizes außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Hinweis

Weitere Informationen

Gilt für:

SetValue(Object, Int64, Int64)

Quelle:: Array.cs

Quelle:: Array.cs

Quelle:: Array.cs

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

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

public void SetValue (object? value, long index1, long index2);

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

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

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

[<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 für die erste Dimension des festzulegenden Array-Elements darstellt.

index2: Int64

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

Attribute: ComVisibleAttribute

Ausnahmen

ArgumentException

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

InvalidCastException

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

ArgumentOutOfRangeException

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

Hinweise

Die GetLowerBound Methoden und GetUpperBound können bestimmen, ob einer der Indizes außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Hinweis

Weitere Informationen

Gilt für:

SetValue(Object, Int32, Int32, Int32)

Quelle:: Array.cs

Quelle:: Array.cs

Quelle:: Array.cs

Legt einen Wert auf das Element an der angegebenen Position im dreidimensionalen Array fest. 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);

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 für die erste Dimension des festzulegenden Array-Elements darstellt.

index2: Int32

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

index3: Int32

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

Ausnahmen

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.

Hinweise

Die GetLowerBound Methoden und GetUpperBound können bestimmen, ob einer der Indizes außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Hinweis

Weitere Informationen

Gilt für:

SetValue(Object, Int64, Int64, Int64)

Quelle:: Array.cs

Quelle:: Array.cs

Quelle:: Array.cs

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

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

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

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

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

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

[<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 für die erste Dimension des festzulegenden Array-Elements darstellt.

index2: Int64

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

index3: Int64

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

Attribute: ComVisibleAttribute

Ausnahmen

ArgumentException

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

InvalidCastException

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

ArgumentOutOfRangeException

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

Hinweise

Die GetLowerBound Methoden und GetUpperBound können bestimmen, ob einer der Indizes außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Hinweis

Weitere Informationen

Gilt für:

SetValue(Object, Int64)

Quelle:: Array.cs

Quelle:: Array.cs

Quelle:: Array.cs

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

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

public void SetValue (object? value, long index);

public void SetValue (object value, long index);

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

member this.SetValue : obj * int64 -> unit

[<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 festzulegenden Array-Elements darstellt.

Attribute: ComVisibleAttribute

Ausnahmen

ArgumentException

Das aktuelle Array verfügt nicht über genau eine Dimension.

InvalidCastException

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

ArgumentOutOfRangeException

index liegt außerhalb des Bereichs der gültigen Indizes für das aktuelle Array.

Hinweise

Die GetLowerBound Methoden und GetUpperBound können bestimmen, ob der Wert von index außerhalb der Grenzen liegt.

Weitere Informationen zu Konvertierungen finden Sie unter Convert.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Hinweis

Weitere Informationen

Gilt für:

Teilen über

Array.SetValue Methode

Definition

Überlädt

Beispiele

SetValue(Object, Int32)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

SetValue(Object, Int32[])

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

SetValue(Object, Int64[])

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

SetValue(Object, Int32, Int32)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

SetValue(Object, Int64, Int64)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

SetValue(Object, Int32, Int32, Int32)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

SetValue(Object, Int64, Int64, Int64)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

SetValue(Object, Int64)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen