Sdílet prostřednictvím


Array.SetValue Metoda

Definice

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

Přetížení

SetValue(Object, Int32)

Nastaví hodnotu elementu na zadané pozici v jednorozměrném Arrayobjektu . Index je zadaný jako 32bitové celé číslo.

SetValue(Object, Int32[])

Nastaví hodnotu prvku na zadané pozici v multidimenzionálním Arrayobjektu . Indexy jsou zadané jako pole 32bitových celých čísel.

SetValue(Object, Int64[])

Nastaví hodnotu prvku na zadané pozici v multidimenzionálním Arrayobjektu . Indexy jsou zadané jako pole 64bitových celých čísel.

SetValue(Object, Int32, Int32)

Nastaví hodnotu elementu na zadané pozici v dvojrozměrném Arrayobjektu . Indexy jsou udávány jako 32bitová celá čísla.

SetValue(Object, Int64, Int64)

Nastaví hodnotu elementu na zadané pozici v dvojrozměrném Arrayobjektu . Indexy jsou udávány jako 64bitová celá čísla.

SetValue(Object, Int32, Int32, Int32)

Nastaví hodnotu elementu na zadané pozici v trojrozměrném Arrayobjektu . Indexy jsou udávány jako 32bitová celá čísla.

SetValue(Object, Int64, Int64, Int64)

Nastaví hodnotu elementu na zadané pozici v trojrozměrném Arrayobjektu . Indexy jsou udávány jako 64bitová celá čísla.

SetValue(Object, Int64)

Nastaví hodnotu elementu na zadané pozici v jednorozměrném Arrayobjektu . Index je zadaný jako 64bitové celé číslo.

Příklady

Následující příklad kódu ukazuje, jak nastavit a získat určitou hodnotu v jednorozměrném nebo vícerozměrném poli.

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)

Zdroj:
Array.cs
Zdroj:
Array.cs
Zdroj:
Array.cs

Nastaví hodnotu elementu na zadané pozici v jednorozměrném Arrayobjektu . Index je zadaný jako 32bitové celé číslo.

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)

Parametry

value
Object

Nová hodnota pro zadaného prvku.

index
Int32

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

Výjimky

Proud Array nemá přesně jednu dimenzi.

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

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

Poznámky

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

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

Tato metoda je operace O(1).

Poznámka

Pokud SetValue se používá k přiřazení null k prvku pole hodnotových typů, všechna pole elementu jsou inicializována na nulu. Hodnotou prvku není odkaz s hodnotou null a nelze ji najít hledáním odkazu s hodnotou null.

Viz také

Platí pro

SetValue(Object, Int32[])

Zdroj:
Array.cs
Zdroj:
Array.cs
Zdroj:
Array.cs

Nastaví hodnotu prvku na zadané pozici v multidimenzionálním Arrayobjektu . Indexy jsou zadané 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);
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ého prvku.

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

indices je null.

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

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

Libovolný prvek v indices souboru je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Arrayobjektu .

Poznámky

Počet prvků v indices souboru se musí rovnat počtu dimenzí v objektu Array. Všechny prvky v indices poli musí souhrnně určovat pozici požadovaného prvku v multidimenzionálním Arrayobjektu .

Metody GetLowerBound a GetUpperBound mohou určit, zda je některá z hodnot v matici indices mimo hranice.

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

Tato metoda je operace O(1).

Poznámka

Pokud SetValue se používá k přiřazení null k prvku pole hodnotových typů, všechna pole elementu jsou inicializována na nulu. Hodnotou prvku není odkaz s hodnotou null a nelze ji najít hledáním odkazu s hodnotou null.

Viz také

Platí pro

SetValue(Object, Int64[])

Zdroj:
Array.cs
Zdroj:
Array.cs
Zdroj:
Array.cs

Nastaví hodnotu prvku na zadané pozici v multidimenzionálním Arrayobjektu . Indexy jsou zadané 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);
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())

Parametry

value
Object

Nová hodnota pro zadaného prvku.

indices
Int64[]

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

Atributy

Výjimky

indices je null.

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

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

Libovolný prvek v indices souboru je mimo rozsah platných indexů pro odpovídající dimenzi aktuálního Arrayobjektu .

Poznámky

Počet prvků v indices souboru se musí rovnat počtu dimenzí v objektu Array. Všechny prvky v indices poli musí souhrnně určovat pozici požadovaného prvku v multidimenzionálním Arrayobjektu .

Metody GetLowerBound a GetUpperBound mohou určit, zda je některá z hodnot v matici indices mimo hranice.

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

Tato metoda je operace O(1).

Poznámka

Pokud SetValue se používá k přiřazení null k prvku pole hodnotových typů, všechna pole elementu jsou inicializována na nulu. Hodnotou prvku není odkaz s hodnotou null a nelze ji najít hledáním odkazu s hodnotou null.

Viz také

Platí pro

SetValue(Object, Int32, Int32)

Zdroj:
Array.cs
Zdroj:
Array.cs
Zdroj:
Array.cs

Nastaví hodnotu elementu na zadané pozici v dvojrozměrném Arrayobjektu . Indexy jsou udávány jako 32bitová celá čísla.

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)

Parametry

value
Object

Nová hodnota pro zadaného prvku.

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

Proud Array nemá přesně dva rozměry.

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

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

Poznámky

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

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

Tato metoda je operace O(1).

Poznámka

Pokud SetValue se používá k přiřazení null k prvku pole hodnotových typů, všechna pole elementu jsou inicializována na nulu. Hodnotou prvku není odkaz s hodnotou null a nelze ji najít hledáním odkazu s hodnotou null.

Viz také

Platí pro

SetValue(Object, Int64, Int64)

Zdroj:
Array.cs
Zdroj:
Array.cs
Zdroj:
Array.cs

Nastaví hodnotu prvku na zadané pozici v dvojrozměrném Arrayobjektu . Indexy jsou udávány jako 64bitová celá čísla.

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)

Parametry

value
Object

Nová hodnota pro zadaného prvku.

index1
Int64

64bitové celé číslo, které představuje index první dimenze elementu Array nastavit.

index2
Int64

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

Atributy

Výjimky

Proud Array nemá přesně dva rozměry.

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

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

Poznámky

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

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

Tato metoda je operace O(1).

Poznámka

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

Viz také

Platí pro

SetValue(Object, Int32, Int32, Int32)

Zdroj:
Array.cs
Zdroj:
Array.cs
Zdroj:
Array.cs

Nastaví hodnotu prvku na zadané pozici v trojrozměrném Arrayobjektu . Indexy jsou udávány 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);
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ého prvku.

index1
Int32

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

index2
Int32

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

index3
Int32

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

Výjimky

Proud Array nemá přesně tři rozměry.

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

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

Poznámky

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

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

Tato metoda je operace O(1).

Poznámka

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

Viz také

Platí pro

SetValue(Object, Int64, Int64, Int64)

Zdroj:
Array.cs
Zdroj:
Array.cs
Zdroj:
Array.cs

Nastaví hodnotu prvku na zadané pozici v trojrozměrném Arrayobjektu . Indexy jsou udávány 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);
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)

Parametry

value
Object

Nová hodnota pro zadaného prvku.

index1
Int64

64bitové celé číslo, které představuje index první dimenze elementu Array nastavit.

index2
Int64

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

index3
Int64

64bitové celé číslo, které představuje index třetí dimenze elementu Array k nastavení.

Atributy

Výjimky

Proud Array nemá přesně tři rozměry.

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

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

Poznámky

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

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

Tato metoda je operace O(1).

Poznámka

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

Viz také

Platí pro

SetValue(Object, Int64)

Zdroj:
Array.cs
Zdroj:
Array.cs
Zdroj:
Array.cs

Nastaví hodnotu prvku na zadané pozici v jednorozměrném Arrayobjektu . Index je určen jako 64bitové celé číslo.

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)

Parametry

value
Object

Nová hodnota pro zadaného prvku.

index
Int64

64bitové celé číslo, které představuje pozici Array prvku, který má být nastaven.

Atributy

Výjimky

Proud Array nemá přesně jednu dimenzi.

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

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

Poznámky

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

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

Tato metoda je operace O(1).

Poznámka

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

Viz také

Platí pro