Array.SetValue Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Nastaví zadaný prvek v aktuálním Array na zadanou hodnotu.

Přetížení

Name	Description
SetValue(Object, Int32)	Nastaví hodnotu prvku na zadané pozici v jednorozměrném Arrayobjektu . Index se zadává jako 32bitové celé číslo.
SetValue(Object, Int32[])	Nastaví hodnotu prvku na zadané pozici v multidimenzionální Array. Indexy se zadají jako pole 32bitových celých čísel.
SetValue(Object, Int64[])	Nastaví hodnotu prvku na zadané pozici v multidimenzionální Array. Indexy se zadají jako pole 64bitových celých čísel.
SetValue(Object, Int32, Int32)	Nastaví hodnotu prvku na určené pozici v dvojrozměrné Array. Indexy se zadají jako 32bitová celá čísla.
SetValue(Object, Int64, Int64)	Nastaví hodnotu prvku na určené pozici v dvojrozměrné Array. Indexy se zadají jako 64bitová celá čísla.
SetValue(Object, Int32, Int32, Int32)	Nastaví hodnotu prvku na zadané pozici v trojrozměrném Arrayobjektu . Indexy se zadají jako 32bitová celá čísla.
SetValue(Object, Int64, Int64, Int64)	Nastaví hodnotu prvku na zadané pozici v trojrozměrném Arrayobjektu . Indexy se zadají jako 64bitová celá čísla.
SetValue(Object, Int64)	Nastaví hodnotu prvku na zadané pozici v jednorozměrném Arrayobjektu . Index se zadává jako 64bitové celé číslo.

Příklady

Následující příklad kódu ukazuje, jak nastavit a získat konkrétní hodnotu v jednorozměrném nebo multidimenzionálním poli.

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)

Zdroj:

Array.cs

Nastaví hodnotu prvku na zadané pozici v jednorozměrném Arrayobjektu . Index se zadává jako 32bitové celé číslo.

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)

Parametry

value

Object

Nová hodnota pro zadaný prvek.

index

Int32

32bitové celé číslo, které představuje pozici Array prvku, který se má nastavit.

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně jednu dimenzi.

InvalidCastException

value nelze přetypovat na typ prvku aktuálního Array.

IndexOutOfRangeException

index je mimo rozsah platných indexů pro aktuální Array.

Poznámky

GetLowerBound Metody GetUpperBound mohou určit, zda je hodnota index mimo hranice.

Další informace o převodech naleznete v tématu Convert.

Tato metoda je operace O(1).

Note

Pokud SetValue se používá k přiřazení null prvku pole typů hodnot, jsou všechna pole prvku inicializována na nulu. Hodnota elementu není odkaz null a nelze ji najít hledáním nulového odkazu.

Viz také

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

SetValue(Object, Int32[])

Zdroj:

Array.cs

Nastaví hodnotu prvku na zadané pozici v multidimenzionální Array. Indexy se zadají jako pole 32bitových celých čísel.

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

Parametry

value

Object

Nová hodnota pro zadaný prvek.

indices

Int32[]

Jednorozměrné pole 32bitových celých čísel, které představují indexy určující pozici prvku, který se má nastavit.

Výjimky

ArgumentNullException

indices je null.

ArgumentException

Počet dimenzí v aktuálním proudu Array se nerovná počtu prvků v indices.

InvalidCastException

value nelze přetypovat na typ prvku aktuálního Array.

IndexOutOfRangeException

Jakýkoli prvek je indices mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

Počet prvků v indices musí být roven počtu dimenzí v Arraysadě . Všechny prvky v indices poli musí souhrnně určit pozici požadovaného prvku v multidimenzionální Array.

Metody GetLowerBound mohou GetUpperBound určit, zda některé z hodnot v indices poli jsou mimo hranice.

Další informace o převodech naleznete v tématu Convert.

Tato metoda je operace O(1).

Note

Pokud SetValue se používá k přiřazení null prvku pole typů hodnot, jsou všechna pole prvku inicializována na nulu. Hodnota elementu není odkaz null a nelze ji najít hledáním nulového odkazu.

Viz také

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

SetValue(Object, Int64[])

Zdroj:

Array.cs

Nastaví hodnotu prvku na zadané pozici v multidimenzionální Array. Indexy se zadají jako pole 64bitových celých čísel.

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

Parametry

value

Object

Nová hodnota pro zadaný prvek.

indices

Int64[]

Jednorozměrné pole 64bitových celých čísel, které představují indexy určující pozici prvku, který se má nastavit.

Výjimky

ArgumentNullException

indices je null.

ArgumentException

Počet dimenzí v aktuálním proudu Array se nerovná počtu prvků v indices.

InvalidCastException

value nelze přetypovat na typ prvku aktuálního Array.

ArgumentOutOfRangeException

Jakýkoli prvek je indices mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

Počet prvků v indices musí být roven počtu dimenzí v Arraysadě . Všechny prvky v indices poli musí souhrnně určit pozici požadovaného prvku v multidimenzionální Array.

Metody GetLowerBound mohou GetUpperBound určit, zda některé z hodnot v indices poli jsou mimo hranice.

Další informace o převodech naleznete v tématu Convert.

Tato metoda je operace O(1).

Note

Pokud SetValue se používá k přiřazení null prvku pole typů hodnot, jsou všechna pole prvku inicializována na nulu. Hodnota elementu není odkaz null a nelze ji najít hledáním nulového odkazu.

Viz také

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

SetValue(Object, Int32, Int32)

Zdroj:

Array.cs

Nastaví hodnotu prvku na určené pozici v dvojrozměrné Array. Indexy se zadají jako 32bitová celá čísla.

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)

Parametry

value

Object

Nová hodnota pro zadaný prvek.

index1

Int32

32bitové celé číslo, které představuje index první dimenze elementu Array , který se má nastavit.

index2

Int32

32bitové celé číslo, které představuje index druhé dimenze elementu Array , který se má nastavit.

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně dvě dimenze.

InvalidCastException

value nelze přetypovat na typ prvku aktuálního Array.

IndexOutOfRangeException

Buď index1 nebo index2 je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Další informace o převodech naleznete v tématu Convert.

Tato metoda je operace O(1).

Note

Pokud SetValue se používá k přiřazení null prvku pole typů hodnot, jsou všechna pole prvku inicializována na nulu. Hodnota elementu není odkaz null a nelze ji najít hledáním nulového odkazu.

Viz také

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

SetValue(Object, Int64, Int64)

Zdroj:

Array.cs

Nastaví hodnotu prvku na určené pozici v dvojrozměrné Array. Indexy se zadají jako 64bitová celá čísla.

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)

Parametry

value

Object

Nová hodnota pro zadaný prvek.

index1

Int64

64bitové celé číslo, které představuje index Array první dimenze prvku, který se má nastavit.

index2

Int64

64bitové celé číslo, které představuje index Array druhé dimenze prvku, který se má nastavit.

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně dvě dimenze.

InvalidCastException

value nelze přetypovat na typ prvku aktuálního Array.

ArgumentOutOfRangeException

Buď index1 nebo index2 je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Další informace o převodech naleznete v tématu Convert.

Tato metoda je operace O(1).

Note

Pokud SetValue se používá k přiřazení null prvku pole typů hodnot, jsou všechna pole prvku inicializována na nulu. Hodnota elementu není odkaz null a nelze ji najít hledáním nulového odkazu.

Viz také

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

SetValue(Object, Int32, Int32, Int32)

Zdroj:

Array.cs

Nastaví hodnotu prvku na zadané pozici v trojrozměrném Arrayobjektu . Indexy se zadají jako 32bitová celá čísla.

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)

Parametry

value

Object

Nová hodnota pro zadaný prvek.

index1

Int32

32bitové celé číslo, které představuje index první dimenze elementu Array , který se má nastavit.

index2

Int32

32bitové celé číslo, které představuje index druhé dimenze elementu Array , který se má nastavit.

index3

Int32

32bitové celé číslo, které představuje index třetí dimenze elementu Array , který se má nastavit.

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně tři rozměry.

InvalidCastException

value nelze přetypovat na typ prvku aktuálního Array.

IndexOutOfRangeException

index1 nebo index2index3 je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Další informace o převodech naleznete v tématu Convert.

Tato metoda je operace O(1).

Note

Pokud SetValue se používá k přiřazení null prvku pole typů hodnot, jsou všechna pole prvku inicializována na nulu. Hodnota elementu není odkaz null a nelze ji najít hledáním nulového odkazu.

Viz také

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

SetValue(Object, Int64, Int64, Int64)

Zdroj:

Array.cs

Nastaví hodnotu prvku na zadané pozici v trojrozměrném Arrayobjektu . Indexy se zadají jako 64bitová celá čísla.

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)

Parametry

value

Object

Nová hodnota pro zadaný prvek.

index1

Int64

64bitové celé číslo, které představuje index Array první dimenze prvku, který se má nastavit.

index2

Int64

64bitové celé číslo, které představuje index Array druhé dimenze prvku, který se má nastavit.

index3

Int64

64bitové celé číslo, které představuje index třetí dimenze elementu Array , který se má nastavit.

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně tři rozměry.

InvalidCastException

value nelze přetypovat na typ prvku aktuálního Array.

ArgumentOutOfRangeException

index1 nebo index2index3 je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Array.

Poznámky

GetLowerBound A GetUpperBound metody mohou určit, zda některý z indexů je mimo hranice.

Další informace o převodech naleznete v tématu Convert.

Tato metoda je operace O(1).

Note

Pokud SetValue se používá k přiřazení null prvku pole typů hodnot, jsou všechna pole prvku inicializována na nulu. Hodnota elementu není odkaz null a nelze ji najít hledáním nulového odkazu.

Viz také

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

SetValue(Object, Int64)

Zdroj:

Array.cs

Nastaví hodnotu prvku na zadané pozici v jednorozměrném Arrayobjektu . Index se zadává jako 64bitové celé číslo.

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)

Parametry

value

Object

Nová hodnota pro zadaný prvek.

index

Int64

64bitové celé číslo, které představuje pozici Array prvku, který se má nastavit.

Výjimky

ArgumentException

Aktuální Array hodnota nemá přesně jednu dimenzi.

InvalidCastException

value nelze přetypovat na typ prvku aktuálního Array.

ArgumentOutOfRangeException

index je mimo rozsah platných indexů pro aktuální Array.

Poznámky

GetLowerBound Metody GetUpperBound mohou určit, zda je hodnota index mimo hranice.

Další informace o převodech naleznete v tématu Convert.

Tato metoda je operace O(1).

Note

Pokud SetValue se používá k přiřazení null prvku pole typů hodnot, jsou všechna pole prvku inicializována na nulu. Hodnota elementu není odkaz null a nelze ji najít hledáním nulového odkazu.

Viz také

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