Array.GetValue 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得目前 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 中位於指定位置的值。

例外狀況

ArgumentException

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

IndexOutOfRangeException

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

備註

GetLowerBound和 GetUpperBound 方法可以判斷的值 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 中位於指定位置的值。

例外狀況

ArgumentNullException

indices 為 null。

ArgumentException

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

IndexOutOfRangeException

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

備註

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

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

這個方法是 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 中位於指定位置的值。

屬性: ComVisibleAttribute

例外狀況

ArgumentException

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

ArgumentOutOfRangeException

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

備註

GetLowerBound和 GetUpperBound 方法可以判斷的值 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 中位於指定位置的值。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

indices 為 null。

ArgumentException

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

ArgumentOutOfRangeException

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

備註

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

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

這個方法是 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 中位於指定位置的值。

例外狀況

ArgumentException

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

IndexOutOfRangeException

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

備註

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

這個方法是 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 中位於指定位置的值。

屬性: ComVisibleAttribute

例外狀況

ArgumentException

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

ArgumentOutOfRangeException

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

備註

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

這個方法是 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 中位於指定位置的值。

例外狀況

ArgumentException

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

IndexOutOfRangeException

index1 或 index2 或 index3 超出目前 Array 之相對應維度的有效索引範圍。

備註

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

這個方法是 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 中位於指定位置的值。

屬性: ComVisibleAttribute

例外狀況

ArgumentException

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

ArgumentOutOfRangeException

index1 或 index2 或 index3 超出目前 Array 之相對應維度的有效索引範圍。

備註

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

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

另請參閱

適用於

共用方式為

Array.GetValue 方法

定義

多載

範例

GetValue(Int32)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetValue(Int32[])

參數

傳回

例外狀況

備註

另請參閱

適用於

GetValue(Int64)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetValue(Int64[])

參數

傳回

例外狀況

備註

另請參閱

適用於

GetValue(Int32, Int32)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetValue(Int64, Int64)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetValue(Int32, Int32, Int32)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetValue(Int64, Int64, Int64)

參數

傳回

例外狀況

備註

另請參閱

適用於

其他資源