Bagikan melalui


Array.SetValue Metode

Definisi

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

Saat ini Array tidak memiliki tepat satu dimensi.

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

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

indicesadalah null.

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

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

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

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, 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

Pengecualian

indicesadalah null.

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

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

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

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, 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

Saat ini Array tidak memiliki tepat dua dimensi.

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

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

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, 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

Pengecualian

Saat ini Array tidak memiliki tepat dua dimensi.

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

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

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, 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

Saat ini Array tidak memiliki tepat tiga dimensi.

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

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

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, 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

Pengecualian

Saat ini Array tidak memiliki tepat tiga dimensi.

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

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

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, 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

Pengecualian

Saat ini Array tidak memiliki tepat satu dimensi.

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

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