Array.SetValue Metode

Referensi

Definisi

Ruang nama:: System

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengatur elemen yang ditentukan dalam saat ini Array ke nilai yang ditentukan.

Overload

SetValue(Object, Int32)	Mengatur nilai ke elemen pada posisi yang ditentukan dalam satu dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.
SetValue(Object, Int32[])	Mengatur nilai ke elemen pada posisi yang ditentukan dalam multidmensional Array. Indeks ditentukan sebagai array bilangan bulat 32-bit.
SetValue(Object, Int64[])	Mengatur nilai ke elemen pada posisi yang ditentukan dalam multidmensional Array. Indeks ditentukan sebagai array bilangan bulat 64-bit.
SetValue(Object, Int32, Int32)	Mengatur nilai ke elemen pada posisi yang ditentukan dalam dua dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.
SetValue(Object, Int64, Int64)	Mengatur nilai ke elemen pada posisi yang ditentukan dalam dua dimensi Array. Indeks ditentukan sebagai bilangan bulat 64-bit.
SetValue(Object, Int32, Int32, Int32)	Mengatur nilai ke elemen pada posisi yang ditentukan dalam tiga dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.
SetValue(Object, Int64, Int64, Int64)	Mengatur nilai ke elemen pada posisi yang ditentukan dalam tiga dimensi Array. Indeks ditentukan sebagai bilangan bulat 64-bit.
SetValue(Object, Int64)	Mengatur nilai ke elemen pada posisi yang ditentukan dalam satu dimensi Array. Indeks ditentukan sebagai bilangan bulat 64-bit.

Contoh

Contoh kode berikut menunjukkan cara mengatur dan mendapatkan nilai tertentu dalam array satu dimensi atau multidampingan.

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)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mengatur nilai ke elemen pada posisi yang ditentukan dalam satu dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.

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)

Parameter

value: Object

Nilai baru untuk elemen yang ditentukan.

index: Int32

Bilangan bulat 32-bit yang mewakili posisi elemen yang Array akan diatur.

Pengecualian

ArgumentException

Saat ini Array tidak memiliki tepat satu dimensi.

InvalidCastException

value tidak dapat dilemparkan ke jenis elemen dari saat ini Array.

IndexOutOfRangeException

index berada di luar rentang indeks yang valid untuk saat ini Array.

Keterangan

Metode GetLowerBound dan GetUpperBound dapat menentukan apakah nilai index berada di luar batas.

Untuk informasi selengkapnya tentang konversi, lihat Convert.

Metode ini adalah operasi O(1).

Catatan

Jika SetValue digunakan untuk menetapkan null ke elemen dari array jenis nilai, semua bidang elemen diinisialisasi ke nol. Nilai elemen bukan referensi null, dan tidak dapat ditemukan dengan mencari referensi null.

Lihat juga

Berlaku untuk

SetValue(Object, Int32[])

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mengatur nilai ke elemen pada posisi yang ditentukan dalam multidmensional Array. Indeks ditentukan sebagai array bilangan bulat 32-bit.

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

Parameter

value: Object

Nilai baru untuk elemen yang ditentukan.

indices: Int32[]

Array satu dimensi bilangan bulat 32-bit yang mewakili indeks yang menentukan posisi elemen yang akan diatur.

Pengecualian

ArgumentNullException

indicesadalah null.

ArgumentException

Jumlah dimensi dalam saat ini Array tidak sama dengan jumlah elemen di indices.

InvalidCastException

value tidak dapat dilemparkan ke jenis elemen dari saat ini Array.

IndexOutOfRangeException

Elemen apa pun di berada di indices luar rentang indeks yang valid untuk dimensi yang sesuai dari saat ini Array.

Keterangan

Jumlah elemen dalam indices harus sama dengan jumlah dimensi dalam Array. Semua elemen dalam indices array harus secara kolektif menentukan posisi elemen yang diinginkan dalam multidmensional Array.

Metode GetLowerBound dan GetUpperBound dapat menentukan apakah salah satu nilai dalam array berada di indices luar batas.

Untuk informasi selengkapnya tentang konversi, lihat Convert.

Metode ini adalah operasi O(1).

Catatan

Lihat juga

Berlaku untuk

SetValue(Object, Int64[])

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mengatur nilai ke elemen pada posisi yang ditentukan dalam multidmensional Array. Indeks ditentukan sebagai array bilangan bulat 64-bit.

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

Parameter

value: Object

Nilai baru untuk elemen yang ditentukan.

indices: Int64[]

Array satu dimensi bilangan bulat 64-bit yang mewakili indeks yang menentukan posisi elemen yang akan diatur.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentNullException

indicesadalah null.

ArgumentException

Jumlah dimensi dalam saat ini Array tidak sama dengan jumlah elemen di indices.

InvalidCastException

value tidak dapat dilemparkan ke jenis elemen dari saat ini Array.

ArgumentOutOfRangeException

Elemen apa pun di berada di indices luar rentang indeks yang valid untuk dimensi yang sesuai dari saat ini Array.

Keterangan

Metode GetLowerBound dan GetUpperBound dapat menentukan apakah salah satu nilai dalam array berada di indices luar batas.

Untuk informasi selengkapnya tentang konversi, lihat Convert.

Metode ini adalah operasi O(1).

Catatan

Lihat juga

Berlaku untuk

SetValue(Object, Int32, Int32)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mengatur nilai ke elemen pada posisi yang ditentukan dalam dua dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.

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)

Parameter

value: Object

Nilai baru untuk elemen yang ditentukan.

index1: Int32

Bilangan bulat 32-bit yang mewakili indeks dimensi pertama elemen yang Array akan diatur.

index2: Int32

Bilangan bulat 32-bit yang mewakili indeks dimensi kedua dari elemen yang Array akan diatur.

Pengecualian

ArgumentException

Saat ini Array tidak memiliki tepat dua dimensi.

InvalidCastException

value tidak dapat dilemparkan ke jenis elemen dari saat ini Array.

IndexOutOfRangeException

Baik index1 atau index2 berada di luar rentang indeks yang valid untuk dimensi yang sesuai dari saat ini Array.

Keterangan

Metode GetLowerBound dan GetUpperBound dapat menentukan apakah salah satu indeks berada di luar batas.

Untuk informasi selengkapnya tentang konversi, lihat Convert.

Metode ini adalah operasi O(1).

Catatan

Lihat juga

Berlaku untuk

SetValue(Object, Int64, Int64)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mengatur nilai ke elemen pada posisi yang ditentukan dalam dua dimensi Array. Indeks ditentukan sebagai bilangan bulat 64-bit.

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)

Parameter

value: Object

Nilai baru untuk elemen yang ditentukan.

index1: Int64

Bilangan bulat 64-bit yang mewakili indeks dimensi pertama elemen yang Array akan diatur.

index2: Int64

Bilangan bulat 64-bit yang mewakili indeks dimensi kedua elemen yang Array akan diatur.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentException

Saat ini Array tidak memiliki tepat dua dimensi.

InvalidCastException

value tidak dapat dilemparkan ke jenis elemen dari saat ini Array.

ArgumentOutOfRangeException

Baik index1 atau index2 berada di luar rentang indeks yang valid untuk dimensi yang sesuai dari saat ini Array.

Keterangan

Metode GetLowerBound dan GetUpperBound dapat menentukan apakah salah satu indeks berada di luar batas.

Untuk informasi selengkapnya tentang konversi, lihat Convert.

Metode ini adalah operasi O(1).

Catatan

Lihat juga

Berlaku untuk

SetValue(Object, Int32, Int32, Int32)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mengatur nilai ke elemen pada posisi yang ditentukan dalam tiga dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.

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)

Parameter

value: Object

Nilai baru untuk elemen yang ditentukan.

index1: Int32

Bilangan bulat 32-bit yang mewakili indeks dimensi pertama elemen yang Array akan diatur.

index2: Int32

Bilangan bulat 32-bit yang mewakili indeks dimensi kedua elemen yang Array akan diatur.

index3: Int32

Bilangan bulat 32-bit yang mewakili indeks dimensi ketiga elemen yang Array akan diatur.

Pengecualian

ArgumentException

Saat ini Array tidak memiliki tepat tiga dimensi.

InvalidCastException

value tidak dapat dilemparkan ke jenis elemen dari saat ini Array.

IndexOutOfRangeException

index1 atau index2 atau index3 berada di luar rentang indeks yang valid untuk dimensi yang sesuai dari saat ini Array.

Keterangan

Metode GetLowerBound dan GetUpperBound dapat menentukan apakah salah satu indeks berada di luar batas.

Untuk informasi selengkapnya tentang konversi, lihat Convert.

Metode ini adalah operasi O(1).

Catatan

Lihat juga

Berlaku untuk

SetValue(Object, Int64, Int64, Int64)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mengatur nilai ke elemen pada posisi yang ditentukan dalam tiga dimensi Array. Indeks ditentukan sebagai bilangan bulat 64-bit.

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)

Parameter

value: Object

Nilai baru untuk elemen yang ditentukan.

index1: Int64

Bilangan bulat 64-bit yang mewakili indeks dimensi pertama elemen yang Array akan diatur.

index2: Int64

Bilangan bulat 64-bit yang mewakili indeks dimensi kedua elemen yang Array akan diatur.

index3: Int64

Bilangan bulat 64-bit yang mewakili indeks dimensi ketiga elemen yang Array akan diatur.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentException

Saat ini Array tidak memiliki tepat tiga dimensi.

InvalidCastException

value tidak dapat dilemparkan ke jenis elemen dari saat ini Array.

ArgumentOutOfRangeException

index1 atau index2 atau index3 berada di luar rentang indeks yang valid untuk dimensi yang sesuai dari saat ini Array.

Keterangan

Metode GetLowerBound dan GetUpperBound dapat menentukan apakah salah satu indeks berada di luar batas.

Untuk informasi selengkapnya tentang konversi, lihat Convert.

Metode ini adalah operasi O(1).

Catatan

Lihat juga

Berlaku untuk

SetValue(Object, Int64)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mengatur nilai ke elemen pada posisi yang ditentukan dalam satu dimensi Array. Indeks ditentukan sebagai bilangan bulat 64-bit.

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)

Parameter

value: Object

Nilai baru untuk elemen yang ditentukan.

index: Int64

Bilangan bulat 64-bit yang mewakili posisi elemen yang Array akan diatur.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentException

Saat ini Array tidak memiliki tepat satu dimensi.

InvalidCastException

value tidak dapat dilemparkan ke jenis elemen dari saat ini Array.

ArgumentOutOfRangeException

index berada di luar rentang indeks yang valid untuk saat ini Array.

Keterangan

Metode GetLowerBound dan GetUpperBound dapat menentukan apakah nilai index berada di luar batas.

Untuk informasi selengkapnya tentang konversi, lihat Convert.

Metode ini adalah operasi O(1).

Catatan

Lihat juga

Berlaku untuk

Array.SetValue Metode

Definisi

Overload

Contoh

SetValue(Object, Int32)

Parameter

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

SetValue(Object, Int32[])

Parameter

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

SetValue(Object, Int64[])

Parameter

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

SetValue(Object, Int32, Int32)

Parameter

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

SetValue(Object, Int64, Int64)

Parameter

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

SetValue(Object, Int32, Int32, Int32)

Parameter

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

SetValue(Object, Int64, Int64, Int64)

Parameter

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

SetValue(Object, Int64)

Parameter

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: