Array.SetValue Methode

Definition

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)

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

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

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

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[])

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

indices ist null.

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

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

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

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, 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.

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

Ausnahmen

indices ist null.

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

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

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

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

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

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

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

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

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

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

Ausnahmen

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

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

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

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

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

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

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

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

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, 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.

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

Ausnahmen

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

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

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

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

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

Ausnahmen

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

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

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: