Array.SetValue Metod

Definition

Namnområde:

System

Sammansättningar:

netstandard.dll, System.Runtime.dll

Anger det angivna elementet i aktuellt Array värde till det angivna värdet.

Överlagringar

Name	Description
SetValue(Object, Int32)	Anger ett värde till elementet på den angivna positionen i den endimensionella Array. Indexet anges som ett 32-bitars heltal.
SetValue(Object, Int32[])	Anger ett värde till elementet på den angivna positionen i flerdimensionella Array. Indexen anges som en matris med 32-bitars heltal.
SetValue(Object, Int64[])	Anger ett värde till elementet på den angivna positionen i flerdimensionella Array. Indexen anges som en matris med 64-bitars heltal.
SetValue(Object, Int32, Int32)	Anger ett värde till elementet på den angivna positionen i den tvådimensionella Array. Indexen anges som 32-bitars heltal.
SetValue(Object, Int64, Int64)	Anger ett värde till elementet på den angivna positionen i den tvådimensionella Array. Indexen anges som 64-bitars heltal.
SetValue(Object, Int32, Int32, Int32)	Anger ett värde till elementet på den angivna positionen i den tredimensionella Array. Indexen anges som 32-bitars heltal.
SetValue(Object, Int64, Int64, Int64)	Anger ett värde till elementet på den angivna positionen i den tredimensionella Array. Indexen anges som 64-bitars heltal.
SetValue(Object, Int64)	Anger ett värde till elementet på den angivna positionen i den endimensionella Array. Indexet anges som ett 64-bitars heltal.

Exempel

Följande kodexempel visar hur du anger och hämtar ett specifikt värde i en endimensionell eller flerdimensionell matris.

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)

Källa:

Array.cs

Anger ett värde till elementet på den angivna positionen i den endimensionella Array. Indexet anges som ett 32-bitars heltal.

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)

Parametrar

value

Object

Det nya värdet för det angivna elementet.

index

Int32

Ett 32-bitars heltal som representerar positionen för det element som Array ska anges.

Undantag

ArgumentException

Array Strömmen har inte exakt en dimension.

InvalidCastException

value kan inte gjutas till elementtypen för den aktuella Array.

IndexOutOfRangeException

index ligger utanför intervallet för giltiga index för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om värdet för index ligger utanför gränserna.

Mer information om konverteringar finns i Convert.

Den här metoden är en O(1)-åtgärd.

Note

Om SetValue används för att tilldela null till ett element i en matris med värdetyper initieras alla fält i elementet till noll. Värdet för elementet är inte en null-referens och kan inte hittas genom att söka efter en null-referens.

Se även

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

SetValue(Object, Int32[])

Källa:

Array.cs

Anger ett värde till elementet på den angivna positionen i flerdimensionella Array. Indexen anges som en matris med 32-bitars heltal.

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

Parametrar

value

Object

Det nya värdet för det angivna elementet.

indices

Int32[]

En endimensionell matris med 32-bitars heltal som representerar indexen som anger positionen för det element som ska anges.

Undantag

ArgumentNullException

indices är null.

ArgumentException

Antalet dimensioner i den aktuella Array är inte lika med antalet element i indices.

InvalidCastException

value kan inte gjutas till elementtypen för den aktuella Array.

IndexOutOfRangeException

Alla element i indices ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Antalet element i indices måste vara lika med antalet dimensioner i Array. Alla element i matrisen indices måste gemensamt ange positionen för det önskade elementet i flerdimensionella Array.

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av värdena i matrisen indices ligger utanför gränserna.

Mer information om konverteringar finns i Convert.

Den här metoden är en O(1)-åtgärd.

Note

Om SetValue används för att tilldela null till ett element i en matris med värdetyper initieras alla fält i elementet till noll. Värdet för elementet är inte en null-referens och kan inte hittas genom att söka efter en null-referens.

Se även

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

SetValue(Object, Int64[])

Källa:

Array.cs

Anger ett värde till elementet på den angivna positionen i flerdimensionella Array. Indexen anges som en matris med 64-bitars heltal.

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

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

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

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

Parametrar

value

Object

Det nya värdet för det angivna elementet.

indices

Int64[]

En endimensionell matris med 64-bitars heltal som representerar indexen som anger positionen för det element som ska anges.

Undantag

ArgumentNullException

indices är null.

ArgumentException

Antalet dimensioner i den aktuella Array är inte lika med antalet element i indices.

InvalidCastException

value kan inte gjutas till elementtypen för den aktuella Array.

ArgumentOutOfRangeException

Alla element i indices ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Antalet element i indices måste vara lika med antalet dimensioner i Array. Alla element i matrisen indices måste gemensamt ange positionen för det önskade elementet i flerdimensionella Array.

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av värdena i matrisen indices ligger utanför gränserna.

Mer information om konverteringar finns i Convert.

Den här metoden är en O(1)-åtgärd.

Note

Om SetValue används för att tilldela null till ett element i en matris med värdetyper initieras alla fält i elementet till noll. Värdet för elementet är inte en null-referens och kan inte hittas genom att söka efter en null-referens.

Se även

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

SetValue(Object, Int32, Int32)

Källa:

Array.cs

Anger ett värde till elementet på den angivna positionen i den tvådimensionella Array. Indexen anges som 32-bitars heltal.

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)

Parametrar

value

Object

Det nya värdet för det angivna elementet.

index1

Int32

Ett 32-bitars heltal som representerar det första dimensionsindexet för det element som Array ska anges.

index2

Int32

Ett 32-bitars heltal som representerar det andra dimensionsindexet för det element som Array ska anges.

Undantag

ArgumentException

Array Strömmen har inte exakt två dimensioner.

InvalidCastException

value kan inte gjutas till elementtypen för den aktuella Array.

IndexOutOfRangeException

Antingen index1 eller index2 ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Mer information om konverteringar finns i Convert.

Den här metoden är en O(1)-åtgärd.

Note

Om SetValue används för att tilldela null till ett element i en matris med värdetyper initieras alla fält i elementet till noll. Värdet för elementet är inte en null-referens och kan inte hittas genom att söka efter en null-referens.

Se även

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

SetValue(Object, Int64, Int64)

Källa:

Array.cs

Anger ett värde till elementet på den angivna positionen i den tvådimensionella Array. Indexen anges som 64-bitars heltal.

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

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

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

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

Parametrar

value

Object

Det nya värdet för det angivna elementet.

index1

Int64

Ett 64-bitars heltal som representerar det första dimensionsindexet för det element som Array ska anges.

index2

Int64

Ett 64-bitars heltal som representerar det andra dimensionsindexet för det element som Array ska anges.

Undantag

ArgumentException

Array Strömmen har inte exakt två dimensioner.

InvalidCastException

value kan inte gjutas till elementtypen för den aktuella Array.

ArgumentOutOfRangeException

Antingen index1 eller index2 ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Mer information om konverteringar finns i Convert.

Den här metoden är en O(1)-åtgärd.

Note

Om SetValue används för att tilldela null till ett element i en matris med värdetyper initieras alla fält i elementet till noll. Värdet för elementet är inte en null-referens och kan inte hittas genom att söka efter en null-referens.

Se även

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

SetValue(Object, Int32, Int32, Int32)

Källa:

Array.cs

Anger ett värde till elementet på den angivna positionen i den tredimensionella Array. Indexen anges som 32-bitars heltal.

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)

Parametrar

value

Object

Det nya värdet för det angivna elementet.

index1

Int32

Ett 32-bitars heltal som representerar det första dimensionsindexet för det element som Array ska anges.

index2

Int32

Ett 32-bitars heltal som representerar det andra dimensionsindexet för det element som Array ska anges.

index3

Int32

Ett 32-bitars heltal som representerar det tredje dimensionsindexet för det element som Array ska anges.

Undantag

ArgumentException

Array Strömmen har inte exakt tre dimensioner.

InvalidCastException

value kan inte gjutas till elementtypen för den aktuella Array.

IndexOutOfRangeException

index1 eller index2index3 ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Mer information om konverteringar finns i Convert.

Den här metoden är en O(1)-åtgärd.

Note

Om SetValue används för att tilldela null till ett element i en matris med värdetyper initieras alla fält i elementet till noll. Värdet för elementet är inte en null-referens och kan inte hittas genom att söka efter en null-referens.

Se även

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

SetValue(Object, Int64, Int64, Int64)

Källa:

Array.cs

Anger ett värde till elementet på den angivna positionen i den tredimensionella Array. Indexen anges som 64-bitars heltal.

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

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

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

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

Parametrar

value

Object

Det nya värdet för det angivna elementet.

index1

Int64

Ett 64-bitars heltal som representerar det första dimensionsindexet för det element som Array ska anges.

index2

Int64

Ett 64-bitars heltal som representerar det andra dimensionsindexet för det element som Array ska anges.

index3

Int64

Ett 64-bitars heltal som representerar det tredje dimensionsindexet för det element som Array ska anges.

Undantag

ArgumentException

Array Strömmen har inte exakt tre dimensioner.

InvalidCastException

value kan inte gjutas till elementtypen för den aktuella Array.

ArgumentOutOfRangeException

index1 eller index2index3 ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Mer information om konverteringar finns i Convert.

Den här metoden är en O(1)-åtgärd.

Note

Om SetValue används för att tilldela null till ett element i en matris med värdetyper initieras alla fält i elementet till noll. Värdet för elementet är inte en null-referens och kan inte hittas genom att söka efter en null-referens.

Se även

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

SetValue(Object, Int64)

Källa:

Array.cs

Anger ett värde till elementet på den angivna positionen i den endimensionella Array. Indexet anges som ett 64-bitars heltal.

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

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

member this.SetValue : obj * int64 -> unit

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

Parametrar

value

Object

Det nya värdet för det angivna elementet.

index

Int64

Ett 64-bitars heltal som representerar positionen för det element som Array ska anges.

Undantag

ArgumentException

Array Strömmen har inte exakt en dimension.

InvalidCastException

value kan inte gjutas till elementtypen för den aktuella Array.

ArgumentOutOfRangeException

index ligger utanför intervallet för giltiga index för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om värdet för index ligger utanför gränserna.

Mer information om konverteringar finns i Convert.

Den här metoden är en O(1)-åtgärd.

Note

Om SetValue används för att tilldela null till ett element i en matris med värdetyper initieras alla fält i elementet till noll. Värdet för elementet är inte en null-referens och kan inte hittas genom att söka efter en null-referens.

Se även

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