Array.GetValue Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Возвращает значение указанного элемента в текущем массиве 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).

См. также раздел

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

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).

См. также раздел

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

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).

См. также раздел

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

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).

См. также раздел

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

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).

См. также раздел

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

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).

См. также раздел

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

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).

См. также раздел

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue

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).

См. также раздел

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• SetValue