Array.GetValue 方法

定義

取得目前 Array 中指定項目的值。

多載

GetValue(Int32)

取得一維 Array 中位於指定位置的值。 索引已指定為 32 位元整數。

GetValue(Int32[])

取得多維 Array 中位於指定位置的值。 索引已指定為 32 位元整數的陣列。

GetValue(Int64)

取得一維 Array 中位於指定位置的值。 索引已指定為 64 位元整數。

GetValue(Int64[])

取得多維 Array 中位於指定位置的值。 索引是以 64 位元整數的陣列的方式指定的。

GetValue(Int32, Int32)

取得二維 Array 中位於指定位置的值。 索引已指定為 32 位元整數。

GetValue(Int64, Int64)

取得二維 Array 中位於指定位置的值。 索引是以 64 位元整數的方式指定的。

GetValue(Int32, Int32, Int32)

取得三維 Array 中位於指定位置的值。 索引已指定為 32 位元整數。

GetValue(Int64, Int64, Int64)

取得三維 Array 中位於指定位置的值。 索引是以 64 位元整數的方式指定的。

範例

下列程式碼範例示範如何在一維或多維度陣列中設定和取得特定值。

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

GetValue(Int32)

取得一維 Array 中位於指定位置的值。 索引已指定為 32 位元整數。

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

參數

index
Int32

32 位元整數,代表要取得之 Array 項目的位置。

傳回

Object

一維 Array 中位於指定位置的值。

例外狀況

目前的 Array 並非恰有一個維度。

index 超出目前 Array 的有效索引範圍。

備註

GetLowerBoundGetUpperBound 方法可以判斷 的值 index 是否超出界限。

這個方法是 O (1) 作業。

另請參閱

適用於

GetValue(Int32[])

取得多維 Array 中位於指定位置的值。 索引已指定為 32 位元整數的陣列。

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

參數

indices
Int32[]

32 位元整數的一維陣列,代表指定要取得之 Array 項目位置的索引。

傳回

Object

多維 Array 中位於指定位置的值。

例外狀況

indicesnull

在目前 Array 的維度數目不等於 indices 中的項目數。

indices 中的所有項目都超出 Array 之相對應維度的有效索引範圍 。

備註

中的 indices 專案數目必須等於 中的 Array 維度數目。 陣列中的所有 indices 元素都必須共同指定多維度 Array 中所需專案的位置。

GetLowerBoundGetUpperBound 方法可以判斷任何索引是否超出界限。

這個方法是 O (1) 作業。

另請參閱

適用於

GetValue(Int64)

取得一維 Array 中位於指定位置的值。 索引已指定為 64 位元整數。

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

參數

index
Int64

64 位元整數,代表要取得之 Array 元素的位置。

傳回

Object

一維 Array 中位於指定位置的值。

屬性

例外狀況

目前的 Array 並非恰有一個維度。

index 超出目前 Array 的有效索引範圍。

備註

GetLowerBoundGetUpperBound 方法可以判斷 的值 index 是否超出界限。

這個方法是 O (1) 作業。

另請參閱

適用於

GetValue(Int64[])

取得多維 Array 中位於指定位置的值。 索引是以 64 位元整數的陣列的方式指定的。

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

參數

indices
Int64[]

64 位元整數的一維陣列,代表指定要取得之 Array 元素位置的索引。

傳回

Object

多維 Array 中位於指定位置的值。

屬性

例外狀況

indicesnull

在目前 Array 的維度數目不等於 indices 中的項目數。

indices 中的所有項目都超出 Array 之相對應維度的有效索引範圍 。

備註

中的 indices 專案數目必須等於 中的 Array 維度數目。 陣列中的所有 indices 元素都必須共同指定多維度 Array 中所需專案的位置。

GetLowerBoundGetUpperBound 方法可以判斷任何索引是否超出界限。

這個方法是 O (1) 作業。

另請參閱

適用於

GetValue(Int32, Int32)

取得二維 Array 中位於指定位置的值。 索引已指定為 32 位元整數。

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

參數

index1
Int32

32 位元整數,表示要取得的 Array 項目的第一維索引。

index2
Int32

32 位元整數,表示要取得的 Array 項目的第二維索引。

傳回

Object

二維 Array 中位於指定位置的值。

例外狀況

目前 Array 沒有剛好兩個維度。

index1index2 超出目前 Array 之相對應維度的有效索引範圍。

備註

GetLowerBoundGetUpperBound 方法可以判斷任何索引是否超出界限。

這個方法是 O (1) 作業。

另請參閱

適用於

GetValue(Int64, Int64)

取得二維 Array 中位於指定位置的值。 索引是以 64 位元整數的方式指定的。

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

參數

index1
Int64

64 位元整數,代表要取得的 Array 元素的第一維索引。

index2
Int64

64 位元整數,表示要取得的 Array 元素的第二維索引。

傳回

Object

二維 Array 中位於指定位置的值。

屬性

例外狀況

目前 Array 沒有剛好兩個維度。

index1index2 超出目前 Array 之相對應維度的有效索引範圍。

備註

GetLowerBoundGetUpperBound 方法可以判斷任何索引是否超出界限。

這個方法是 O (1) 作業。

另請參閱

適用於

GetValue(Int32, Int32, Int32)

取得三維 Array 中位於指定位置的值。 索引已指定為 32 位元整數。

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

參數

index1
Int32

32 位元整數,表示要取得的 Array 項目的第一維索引。

index2
Int32

32 位元整數,表示要取得的 Array 項目的第二維索引。

index3
Int32

32 位元整數,表示要取得的 Array 項目的第三維索引。

傳回

Object

三維 Array 中位於指定位置的值。

例外狀況

目前 Array 並非恰有三個維度。

index1index2index3 超出目前 Array 之相對應維度的有效索引範圍 。

備註

GetLowerBoundGetUpperBound 方法可以判斷任何索引是否超出界限。

這個方法是 O (1) 作業。

另請參閱

適用於

GetValue(Int64, Int64, Int64)

取得三維 Array 中位於指定位置的值。 索引是以 64 位元整數的方式指定的。

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

參數

index1
Int64

64 位元整數,代表要取得的 Array 元素的第一維索引。

index2
Int64

64 位元整數,表示要取得的 Array 元素的第二維索引。

index3
Int64

64 位元整數,表示要取得的 Array 元素的第三維索引。

傳回

Object

三維 Array 中位於指定位置的值。

屬性

例外狀況

目前 Array 並非恰有三個維度。

index1index2index3 超出目前 Array 之相對應維度的有效索引範圍 。

備註

GetLowerBoundGetUpperBound 方法可以判斷任何索引是否超出界限。

這個方法是 O (1) 作業。

另請參閱

適用於