Array.GetValue Metode

Definisi

Ruang nama:: System

Rakitan:: mscorlib.dll, System.Runtime.dll

Rakitan:: netstandard.dll, System.Runtime.dll

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.

Mendapatkan nilai elemen yang ditentukan dalam .Array

Overload

Nama	Deskripsi
GetValue(Int32)	Mendapatkan nilai pada posisi yang ditentukan dalam satu dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.
GetValue(Int32[])	Mendapatkan nilai pada posisi yang ditentukan dalam multidireksional Array. Indeks ditentukan sebagai array bilangan bulat 32-bit.
GetValue(Int64)	Mendapatkan nilai pada posisi yang ditentukan dalam satu dimensi Array. Indeks ditentukan sebagai bilangan bulat 64-bit.
GetValue(Int64[])	Mendapatkan nilai pada posisi yang ditentukan dalam multidireksional Array. Indeks ditentukan sebagai array bilangan bulat 64-bit.
GetValue(Int32, Int32)	Mendapatkan nilai pada posisi yang ditentukan dalam dua dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.
GetValue(Int64, Int64)	Mendapatkan nilai pada posisi yang ditentukan dalam dua dimensi Array. Indeks ditentukan sebagai bilangan bulat 64-bit.
GetValue(Int32, Int32, Int32)	Mendapatkan nilai pada posisi yang ditentukan dalam tiga dimensi Array. Indeks ditentukan sebagai bilangan bulat 32-bit.
GetValue(Int64, Int64, Int64)	Mendapatkan nilai pada posisi yang ditentukan dalam tiga 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 multidireksional.

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

GetValue(Int32)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

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

public:
 System::Object ^ GetValue(int index);

public object GetValue(int index);

public object? GetValue(int index);

member this.GetValue : int -> obj

Public Function GetValue (index As Integer) As Object

Parameter

index: Int32

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

Mengembalikan

Object

Nilai pada posisi yang ditentukan dalam satu dimensi Array.

Pengecualian

ArgumentException

Saat ini Array tidak memiliki tepat satu dimensi.

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.

Metode ini adalah operasi O(1).

Lihat juga

Berlaku untuk

GetValue(Int32[])

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mendapatkan nilai pada posisi yang ditentukan dalam multidireksional Array. Indeks ditentukan sebagai array bilangan bulat 32-bit.

public:
 System::Object ^ GetValue(... cli::array <int> ^ indices);

public object GetValue(params int[] indices);

public object? GetValue(params int[] indices);

member this.GetValue : int[] -> obj

Public Function GetValue (ParamArray indices As Integer()) As Object

Parameter

indices: Int32[]

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

Mengembalikan

Object

Nilai pada posisi yang ditentukan dalam multidireksional Array.

Pengecualian

ArgumentNullException

indices adalah null.

ArgumentException

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

IndexOutOfRangeException

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

Keterangan

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

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

Metode ini adalah operasi O(1).

Lihat juga

Berlaku untuk

GetValue(Int64)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

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

public:
 System::Object ^ GetValue(long index);

public object? GetValue(long index);

public object GetValue(long index);

[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue(long index);

member this.GetValue : int64 -> obj

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 -> obj

Public Function GetValue (index As Long) As Object

Parameter

index: Int64

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

Mengembalikan

Object

Nilai pada posisi yang ditentukan dalam satu dimensi Array.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentException

Saat ini Array tidak memiliki tepat satu dimensi.

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.

Metode ini adalah operasi O(1).

Lihat juga

Berlaku untuk

GetValue(Int64[])

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Mendapatkan nilai pada posisi yang ditentukan dalam multidireksional Array. Indeks ditentukan sebagai array bilangan bulat 64-bit.

public:
 System::Object ^ GetValue(... cli::array <long> ^ indices);

public object? GetValue(params long[] indices);

public object GetValue(params long[] indices);

[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue(params long[] indices);

member this.GetValue : int64[] -> obj

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64[] -> obj

Public Function GetValue (ParamArray indices As Long()) As Object

Parameter

indices: Int64[]

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

Mengembalikan

Object

Nilai pada posisi yang ditentukan dalam multidireksional Array.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentNullException

indices adalah null.

ArgumentException

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

ArgumentOutOfRangeException

Elemen apa pun 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 indeks berada di luar batas.

Metode ini adalah operasi O(1).

Lihat juga

Berlaku untuk

GetValue(Int32, Int32)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

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

public:
 System::Object ^ GetValue(int index1, int index2);

public object? GetValue(int index1, int index2);

public object GetValue(int index1, int index2);

member this.GetValue : int * int -> obj

Public Function GetValue (index1 As Integer, index2 As Integer) As Object

Parameter

index1: Int32

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

index2: Int32

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

Mengembalikan

Object

Nilai pada posisi yang ditentukan dalam dua dimensi Array.

Pengecualian

ArgumentException

Arus Array tidak memiliki tepat dua dimensi.

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.

Metode ini adalah operasi O(1).

Lihat juga

Berlaku untuk

GetValue(Int64, Int64)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

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

public:
 System::Object ^ GetValue(long index1, long index2);

public object? GetValue(long index1, long index2);

public object GetValue(long index1, long index2);

[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue(long index1, long index2);

member this.GetValue : int64 * int64 -> obj

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 * int64 -> obj

Public Function GetValue (index1 As Long, index2 As Long) As Object

Parameter

index1: Int64

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

index2: Int64

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

Mengembalikan

Object

Nilai pada posisi yang ditentukan dalam dua dimensi Array.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentException

Arus Array tidak memiliki tepat dua dimensi.

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.

Metode ini adalah operasi O(1).

Lihat juga

Berlaku untuk

GetValue(Int32, Int32, Int32)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

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

public:
 System::Object ^ GetValue(int index1, int index2, int index3);

public object? GetValue(int index1, int index2, int index3);

public object GetValue(int index1, int index2, int index3);

member this.GetValue : int * int * int -> obj

Public Function GetValue (index1 As Integer, index2 As Integer, index3 As Integer) As Object

Parameter

index1: Int32

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

index2: Int32

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

index3: Int32

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

Mengembalikan

Object

Nilai pada posisi yang ditentukan dalam tiga dimensi Array.

Pengecualian

ArgumentException

Arus Array tidak memiliki tepat tiga dimensi.

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.

Metode ini adalah operasi O(1).

Lihat juga

Berlaku untuk

GetValue(Int64, Int64, Int64)

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

Sumber:: Array.cs

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

public:
 System::Object ^ GetValue(long index1, long index2, long index3);

public object? GetValue(long index1, long index2, long index3);

public object GetValue(long index1, long index2, long index3);

[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue(long index1, long index2, long index3);

member this.GetValue : int64 * int64 * int64 -> obj

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 * int64 * int64 -> obj

Public Function GetValue (index1 As Long, index2 As Long, index3 As Long) As Object

Parameter

index1: Int64

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

index2: Int64

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

index3: Int64

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

Mengembalikan

Object

Nilai pada posisi yang ditentukan dalam tiga dimensi Array.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentException

Arus Array tidak memiliki tepat tiga dimensi.

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.

Metode ini adalah operasi O(1).

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?