Array.GetValue メソッド

  • リファレンス

定義

名前空間:
System
アセンブリ:
System.Runtime.dll
アセンブリ:
mscorlib.dll
アセンブリ:
netstandard.dll

現在の Array 内の指定した要素の値を取得します。

オーバーロード

GetValue(Int32)

1 次元 Array 内の指定した位置にある値を取得します。 インデックスは 32 ビット整数値として指定します。
GetValue(Int32[])

多次元 Array 内の指定した位置にある値を取得します。 インデックスは 32 ビット整数値の配列として指定します。
GetValue(Int64)

1 次元 Array 内の指定した位置にある値を取得します。 このインデックスは 64 ビット整数値として指定されます。
GetValue(Int64[])

多次元 Array 内の指定した位置にある値を取得します。 インデックスは 64 ビット整数値の配列として指定します。
GetValue(Int32, Int32)

2 次元 Array 内の指定した位置にある値を取得します。 インデックスは 32 ビット整数値として指定します。
GetValue(Int64, Int64)

2 次元 Array 内の指定した位置にある値を取得します。 インデックスは 64 ビット整数として指定します。
GetValue(Int32, Int32, Int32)

3 次元 Array 内の指定した位置にある値を取得します。 インデックスは 32 ビット整数値として指定します。
GetValue(Int64, Int64, Int64)

3 次元 Array 内の指定した位置にある値を取得します。 インデックスは 64 ビット整数として指定します。

例

次のコード例は、1 次元配列または多次元配列で特定の値を設定および取得する方法を示しています。

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)

1 次元 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

取得する Array 要素の位置を表す 32 ビット整数。

戻り値

Object

1 次元 Array 内の指定した位置にある値。

例外

ArgumentException

現在の Array は正確に 1 つの次元を持つわけではありません。

IndexOutOfRangeException

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[]

取得する Array 要素の位置を指定するインデックスを表す 32 ビット整数の 1 次元配列。

戻り値

Object

多次元 Array 内の指定した位置にある値。

例外

ArgumentNullException

indices が nullです。

ArgumentException

現在の Array の次元数が indices 内の要素の数と等しくありません。

IndexOutOfRangeException

indices 内の要素が、現在の Array の対応する次元の使用可能なインデックスの範囲に含まれていません。

注釈

内 indices の要素の数は、内のディメンションの数と Array等しい必要があります。 配列内のすべての要素は、 indices 多次元 Array内の目的の要素の位置をまとめて指定する必要があります。

GetUpperBoundおよびGetLowerBoundメソッドは、いずれかのインデックスが範囲外であるかどうかを判断できます。

このメソッドは、O(1) 操作です。

こちらもご覧ください

適用対象

GetValue(Int64)

1 次元 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

取得する Array 要素の位置を表す 64 ビット整数。

戻り値

Object

1 次元 Array 内の指定した位置にある値。

属性
ComVisibleAttribute

例外

ArgumentException

現在の Array は正確に 1 つの次元を持つわけではありません。

ArgumentOutOfRangeException

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[]

取得する Array 要素の位置を指定するインデックスを表す 64 ビット整数の 1 次元配列。

戻り値

Object

多次元 Array 内の指定した位置にある値。

属性
ComVisibleAttribute

例外

ArgumentNullException

indices が nullです。

ArgumentException

現在の Array の次元数が indices 内の要素の数と等しくありません。

ArgumentOutOfRangeException

indices 内の要素が、現在の Array の対応する次元の使用可能なインデックスの範囲に含まれていません。

注釈

内 indices の要素の数は、内のディメンションの数と Array等しい必要があります。 配列内のすべての要素は、 indices 多次元 Array内の目的の要素の位置をまとめて指定する必要があります。

GetUpperBoundおよびGetLowerBoundメソッドは、いずれかのインデックスが範囲外であるかどうかを判断できます。

このメソッドは、O(1) 操作です。

こちらもご覧ください

適用対象

GetValue(Int32, Int32)

2 次元 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

取得する Array 要素の最初の次元のインデックスを表す 32 ビット整数。

index2
Int32

取得する Array 要素の 2 番目の次元のインデックスを表す 64 ビット整数。

戻り値

Object

2 次元 Array 内の指定した位置にある値。

例外

ArgumentException

現在の Array が 2 次元ではありません。

IndexOutOfRangeException

index1 または index2 は、現在の Array の対応する次元の使用可能なインデックスの範囲に含まれていません。

注釈

GetUpperBoundおよびGetLowerBoundメソッドは、いずれかのインデックスが範囲外であるかどうかを判断できます。

このメソッドは、O(1) 操作です。

こちらもご覧ください

適用対象

GetValue(Int64, Int64)

2 次元 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

取得する Array 要素の最初の次元のインデックスを表す 64 ビット整数。

index2
Int64

取得する Array 要素の 2 番目の次元のインデックスを表す 64 ビット整数。

戻り値

Object

2 次元 Array 内の指定した位置にある値。

属性
ComVisibleAttribute

例外

ArgumentException

現在の Array が 2 次元ではありません。

ArgumentOutOfRangeException

index1 または index2 は、現在の Array の対応する次元の使用可能なインデックスの範囲に含まれていません。

注釈

GetUpperBoundおよびGetLowerBoundメソッドは、いずれかのインデックスが範囲外であるかどうかを判断できます。

このメソッドは、O(1) 操作です。

こちらもご覧ください

適用対象

GetValue(Int32, Int32, Int32)

3 次元 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

取得する Array 要素の最初の次元のインデックスを表す 32 ビット整数。

index2
Int32

取得する Array 要素の 2 番目の次元のインデックスを表す 64 ビット整数。

index3
Int32

取得する Array 要素の 3 番目の次元のインデックスを表す 32 ビット整数。

戻り値

Object

3 次元 Array 内の指定した位置にある値。

例外

ArgumentException

現在の Array に設定されている次元が 3 つではありません。

IndexOutOfRangeException

index1、index2 または index3 が、現在の Array の対応する次元の正しいインデックスの範囲に含まれていません。

注釈

GetUpperBoundおよびGetLowerBoundメソッドは、いずれかのインデックスが範囲外であるかどうかを判断できます。

このメソッドは、O(1) 操作です。

こちらもご覧ください

適用対象

GetValue(Int64, Int64, Int64)

3 次元 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

取得する Array 要素の最初の次元のインデックスを表す 64 ビット整数。

index2
Int64

取得する Array 要素の 2 番目の次元のインデックスを表す 64 ビット整数。

index3
Int64

取得する Array 要素の 3 番目の次元のインデックスを表す 64 ビット整数。

戻り値

Object

3 次元 Array 内の指定した位置にある値。

属性
ComVisibleAttribute

例外

ArgumentException

現在の Array に設定されている次元が 3 つではありません。

ArgumentOutOfRangeException

index1、index2 または index3 が、現在の Array の対応する次元の正しいインデックスの範囲に含まれていません。

注釈

GetUpperBoundおよびGetLowerBoundメソッドは、いずれかのインデックスが範囲外であるかどうかを判断できます。

このメソッドは、O(1) 操作です。

こちらもご覧ください

適用対象