Array.SetValue Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ArgumentException

Proud Array nemá přesně jednu dimenzi.

InvalidCastException

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

IndexOutOfRangeException

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

ArgumentNullException

indices je null.

ArgumentException

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

InvalidCastException

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

IndexOutOfRangeException

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

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: ComVisibleAttribute

Výjimky

ArgumentNullException

indices je null.

ArgumentException

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

InvalidCastException

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

ArgumentOutOfRangeException

Libovolný prvek v indices souboru 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 hodnot v matici indices mimo hranice.

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

Tato metoda je operace O(1).

Poznámka

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

ArgumentException

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

InvalidCastException

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

IndexOutOfRangeException

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

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: ComVisibleAttribute

Výjimky

ArgumentException

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

InvalidCastException

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

ArgumentOutOfRangeException

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

ArgumentException

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

InvalidCastException

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

IndexOutOfRangeException

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

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: ComVisibleAttribute

Výjimky

ArgumentException

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

InvalidCastException

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

ArgumentOutOfRangeException

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

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: ComVisibleAttribute

Výjimky

ArgumentException

Proud Array nemá přesně jednu dimenzi.

InvalidCastException

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

ArgumentOutOfRangeException

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

Viz také

Platí pro

Sdílet prostřednictvím

Array.SetValue Metoda

Definice

Přetížení

Příklady

SetValue(Object, Int32)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

SetValue(Object, Int32[])

Parametry

Výjimky

Poznámky

Viz také

Platí pro

SetValue(Object, Int64[])

Parametry

Výjimky

Poznámky

Viz také

Platí pro

SetValue(Object, Int32, Int32)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

SetValue(Object, Int64, Int64)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

SetValue(Object, Int32, Int32, Int32)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

SetValue(Object, Int64, Int64, Int64)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

SetValue(Object, Int64)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

Další materiály