Array.SetValue Methode

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Hiermee stelt u het opgegeven element in de huidige Array in op de opgegeven waarde.

Overloads

Name Description
SetValue(Object, Int32)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de eendimensionale Arraypositie. De index wordt opgegeven als een 32-bits geheel getal.
SetValue(Object, Int32[])

Hiermee stelt u een waarde in op het element op de opgegeven positie in de multidimensionale Array. De indexen worden opgegeven als een matrix van 32-bits gehele getallen.
SetValue(Object, Int64)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de eendimensionale Arraypositie. De index wordt opgegeven als een 64-bits geheel getal.
SetValue(Object, Int64[])

Hiermee stelt u een waarde in op het element op de opgegeven positie in de multidimensionale Array. De indexen worden opgegeven als een matrix van 64-bits gehele getallen.
SetValue(Object, Int32, Int32)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de tweedimensionale Arraypositie. De indexen worden opgegeven als 32-bits gehele getallen.
SetValue(Object, Int64, Int64)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de tweedimensionale Arraypositie. De indexen worden opgegeven als 64-bits gehele getallen.
SetValue(Object, Int32, Int32, Int32)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de driedimensionale Arraypositie. De indexen worden opgegeven als 32-bits gehele getallen.
SetValue(Object, Int64, Int64, Int64)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de driedimensionale Arraypositie. De indexen worden opgegeven als 64-bits gehele getallen.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een specifieke waarde kunt instellen en ophalen in een eendimensionale of multidimensionale matrix.

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)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de eendimensionale Arraypositie. De index wordt opgegeven als een 32-bits geheel getal.

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)

Parameters

value
Object

De nieuwe waarde voor het opgegeven element.

index
Int32

Een 32-bits geheel getal dat de positie van het Array element aangeeft dat moet worden ingesteld.

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies één dimensie.

InvalidCastException

value kan niet worden omgezet naar het elementtype van de huidige Array.

IndexOutOfRangeException

index valt buiten het bereik van geldige indexen voor de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of de waarde index buiten de grenzen valt.

Zie voor meer informatie over conversies Convert.

Deze methode is een O(1)-bewerking.

Note

Als SetValue wordt gebruikt om toe te wijzen aan null een element van een matrix met waardetypen, worden alle velden van het element geïnitialiseerd tot nul. De waarde van het element is geen null-verwijzing en kan niet worden gevonden door te zoeken naar een null-verwijzing.

Zie ook

Van toepassing op

SetValue(Object, Int32[])

Hiermee stelt u een waarde in op het element op de opgegeven positie in de multidimensionale Array. De indexen worden opgegeven als een matrix van 32-bits gehele getallen.

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())

Parameters

value
Object

De nieuwe waarde voor het opgegeven element.

indices
Int32[]

Een eendimensionale matrix van 32-bits gehele getallen die de indexen vertegenwoordigen die de positie van het element aangeven dat moet worden ingesteld.

Uitzonderingen

ArgumentNullException

indices is null.

ArgumentException

Het aantal dimensies in de huidige Array is niet gelijk aan het aantal elementen in indices.

InvalidCastException

value kan niet worden omgezet naar het elementtype van de huidige Array.

IndexOutOfRangeException

Elk element valt indices buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidige Array.

Opmerkingen

Het aantal elementen moet indices gelijk zijn aan het aantal dimensies in de Array. Alle elementen in de indices matrix moeten gezamenlijk de positie van het gewenste element in het multidimensionale Arrayelement opgeven.

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de waarden in de indices matrix buiten de grenzen valt.

Zie voor meer informatie over conversies Convert.

Deze methode is een O(1)-bewerking.

Note

Als SetValue wordt gebruikt om toe te wijzen aan null een element van een matrix met waardetypen, worden alle velden van het element geïnitialiseerd tot nul. De waarde van het element is geen null-verwijzing en kan niet worden gevonden door te zoeken naar een null-verwijzing.

Zie ook

Van toepassing op

SetValue(Object, Int64)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de eendimensionale Arraypositie. De index wordt opgegeven als een 64-bits geheel getal.

public:
 void SetValue(System::Object ^ value, long index);
[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, long index);
public void SetValue(object value, long index);
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 -> unit
member this.SetValue : obj * int64 -> unit
Public Sub SetValue (value As Object, index As Long)

Parameters

value
Object

De nieuwe waarde voor het opgegeven element.

index
Int64

Een 64-bits geheel getal dat de positie van het Array element aangeeft dat moet worden ingesteld.

Kenmerken
ComVisibleAttribute

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies één dimensie.

InvalidCastException

value kan niet worden omgezet naar het elementtype van de huidige Array.

ArgumentOutOfRangeException

index valt buiten het bereik van geldige indexen voor de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of de waarde index buiten de grenzen valt.

Zie voor meer informatie over conversies Convert.

Deze methode is een O(1)-bewerking.

Note

Als SetValue wordt gebruikt om toe te wijzen aan null een element van een matrix met waardetypen, worden alle velden van het element geïnitialiseerd tot nul. De waarde van het element is geen null-verwijzing en kan niet worden gevonden door te zoeken naar een null-verwijzing.

Zie ook

Van toepassing op

SetValue(Object, Int64[])

Hiermee stelt u een waarde in op het element op de opgegeven positie in de multidimensionale Array. De indexen worden opgegeven als een matrix van 64-bits gehele getallen.

public:
 void SetValue(System::Object ^ value, ... cli::array <long> ^ indices);
[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, params long[] indices);
public void SetValue(object value, params long[] indices);
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64[] -> unit
member this.SetValue : obj * int64[] -> unit
Public Sub SetValue (value As Object, ParamArray indices As Long())

Parameters

value
Object

De nieuwe waarde voor het opgegeven element.

indices
Int64[]

Een eendimensionale matrix van 64-bits gehele getallen die de indexen vertegenwoordigen die de positie van het element aangeven dat moet worden ingesteld.

Kenmerken
ComVisibleAttribute

Uitzonderingen

ArgumentNullException

indices is null.

ArgumentException

Het aantal dimensies in de huidige Array is niet gelijk aan het aantal elementen in indices.

InvalidCastException

value kan niet worden omgezet naar het elementtype van de huidige Array.

ArgumentOutOfRangeException

Elk element valt indices buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidige Array.

Opmerkingen

Het aantal elementen moet indices gelijk zijn aan het aantal dimensies in de Array. Alle elementen in de indices matrix moeten gezamenlijk de positie van het gewenste element in het multidimensionale Arrayelement opgeven.

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de waarden in de indices matrix buiten de grenzen valt.

Zie voor meer informatie over conversies Convert.

Deze methode is een O(1)-bewerking.

Note

Als SetValue wordt gebruikt om toe te wijzen aan null een element van een matrix met waardetypen, worden alle velden van het element geïnitialiseerd tot nul. De waarde van het element is geen null-verwijzing en kan niet worden gevonden door te zoeken naar een null-verwijzing.

Zie ook

Van toepassing op

SetValue(Object, Int32, Int32)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de tweedimensionale Arraypositie. De indexen worden opgegeven als 32-bits gehele getallen.

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)

Parameters

value
Object

De nieuwe waarde voor het opgegeven element.

index1
Int32

Een 32-bits geheel getal dat de eerste dimensie-index van het Array element vertegenwoordigt dat moet worden ingesteld.

index2
Int32

Een 32-bits geheel getal dat de tweede dimensie-index van het Array element vertegenwoordigt dat moet worden ingesteld.

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies twee dimensies.

InvalidCastException

value kan niet worden omgezet naar het elementtype van de huidige Array.

IndexOutOfRangeException

Of index1 valt buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidigeArray.index2

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Zie voor meer informatie over conversies Convert.

Deze methode is een O(1)-bewerking.

Note

Als SetValue wordt gebruikt om toe te wijzen aan null een element van een matrix met waardetypen, worden alle velden van het element geïnitialiseerd tot nul. De waarde van het element is geen null-verwijzing en kan niet worden gevonden door te zoeken naar een null-verwijzing.

Zie ook

Van toepassing op

SetValue(Object, Int64, Int64)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de tweedimensionale Arraypositie. De indexen worden opgegeven als 64-bits gehele getallen.

public:
 void SetValue(System::Object ^ value, long index1, long index2);
[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, long index1, long index2);
public void SetValue(object value, long index1, long index2);
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 * int64 -> unit
member this.SetValue : obj * int64 * int64 -> unit
Public Sub SetValue (value As Object, index1 As Long, index2 As Long)

Parameters

value
Object

De nieuwe waarde voor het opgegeven element.

index1
Int64

Een 64-bits geheel getal dat de eerste dimensieindex van het Array element vertegenwoordigt dat moet worden ingesteld.

index2
Int64

Een 64-bits geheel getal dat de tweede dimensie-index van het Array element vertegenwoordigt dat moet worden ingesteld.

Kenmerken
ComVisibleAttribute

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies twee dimensies.

InvalidCastException

value kan niet worden omgezet naar het elementtype van de huidige Array.

ArgumentOutOfRangeException

Of index1 valt buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidigeArray.index2

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Zie voor meer informatie over conversies Convert.

Deze methode is een O(1)-bewerking.

Note

Als SetValue wordt gebruikt om toe te wijzen aan null een element van een matrix met waardetypen, worden alle velden van het element geïnitialiseerd tot nul. De waarde van het element is geen null-verwijzing en kan niet worden gevonden door te zoeken naar een null-verwijzing.

Zie ook

Van toepassing op

SetValue(Object, Int32, Int32, Int32)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de driedimensionale Arraypositie. De indexen worden opgegeven als 32-bits gehele getallen.

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)

Parameters

value
Object

De nieuwe waarde voor het opgegeven element.

index1
Int32

Een 32-bits geheel getal dat de eerste dimensie-index van het Array element vertegenwoordigt dat moet worden ingesteld.

index2
Int32

Een 32-bits geheel getal dat de tweede dimensie-index van het Array element vertegenwoordigt dat moet worden ingesteld.

index3
Int32

Een 32-bits geheel getal dat de index van de derde dimensie van het Array element vertegenwoordigt dat moet worden ingesteld.

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies drie dimensies.

InvalidCastException

value kan niet worden omgezet naar het elementtype van de huidige Array.

IndexOutOfRangeException

index1 of index2index3 valt buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Zie voor meer informatie over conversies Convert.

Deze methode is een O(1)-bewerking.

Note

Als SetValue wordt gebruikt om toe te wijzen aan null een element van een matrix met waardetypen, worden alle velden van het element geïnitialiseerd tot nul. De waarde van het element is geen null-verwijzing en kan niet worden gevonden door te zoeken naar een null-verwijzing.

Zie ook

Van toepassing op

SetValue(Object, Int64, Int64, Int64)

Hiermee stelt u een waarde in op het element op de opgegeven positie in de driedimensionale Arraypositie. De indexen worden opgegeven als 64-bits gehele getallen.

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);
public void SetValue(object value, long index1, long index2, long index3);
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 * int64 * int64 -> unit
member this.SetValue : obj * int64 * int64 * int64 -> unit
Public Sub SetValue (value As Object, index1 As Long, index2 As Long, index3 As Long)

Parameters

value
Object

De nieuwe waarde voor het opgegeven element.

index1
Int64

Een 64-bits geheel getal dat de eerste dimensieindex van het Array element vertegenwoordigt dat moet worden ingesteld.

index2
Int64

Een 64-bits geheel getal dat de tweede dimensie-index van het Array element vertegenwoordigt dat moet worden ingesteld.

index3
Int64

Een 64-bits geheel getal dat de index van de derde dimensie van het Array element vertegenwoordigt dat moet worden ingesteld.

Kenmerken
ComVisibleAttribute

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies drie dimensies.

InvalidCastException

value kan niet worden omgezet naar het elementtype van de huidige Array.

ArgumentOutOfRangeException

index1 of index2index3 valt buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Zie voor meer informatie over conversies Convert.

Deze methode is een O(1)-bewerking.

Note

Als SetValue wordt gebruikt om toe te wijzen aan null een element van een matrix met waardetypen, worden alle velden van het element geïnitialiseerd tot nul. De waarde van het element is geen null-verwijzing en kan niet worden gevonden door te zoeken naar een null-verwijzing.

Zie ook

Van toepassing op