Array.GetValue Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.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 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.cs

Возвращает значение по заданной позиции в одномерном Arrayрежиме. Индекс указывается как 32-разрядное целое число.

public:
 System::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.cs

Возвращает значение по заданной позиции в многомерном.Array Индексы указываются в виде массива 32-разрядных целых чисел.

public:
 System::Object ^ GetValue(... cli::array <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.cs

Возвращает значение по заданной позиции в одномерном Arrayрежиме. Индекс указывается как 64-разрядное целое число.

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

public object? GetValue(long index);

member this.GetValue : int64 -> obj

Public Function GetValue (index As Long) As Object

Параметры

index

Int64

64-разрядное целое число, представляющее положение Array элемента для получения.

Возвращаемое значение

Object

Значение по заданной позиции в одномерном Arrayрежиме.

Исключения

ArgumentException

Текущий Array объект не имеет ровно одного измерения.

ArgumentOutOfRangeException

index находится вне диапазона допустимых индексов для текущего Array.

Комментарии

GetLowerBound Методы GetUpperBound могут определить, выходит ли значение index из пределов.

Этот метод является операцией O(1).

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

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

GetValue(Int64[])

Исходный код:

Array.cs

Возвращает значение по заданной позиции в многомерном.Array Индексы указываются в виде массива 64-разрядных целых чисел.

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

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

member this.GetValue : int64[] -> obj

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

Параметры

indices

Int64[]

Одномерный массив 64-разрядных целых чисел, представляющий индексы, указывающие положение Array элемента для получения.

Возвращаемое значение

Object

Значение по заданной позиции в многомерном режиме Array.

Исключения

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

Возвращает значение по заданной позиции в двухмерном Arrayформате. Индексы указываются как 32-разрядные целые числа.

public:
 System::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.cs

Возвращает значение по заданной позиции в двухмерном Arrayформате. Индексы указываются как 64-разрядные целые числа.

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

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

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формате.

Исключения

ArgumentException

Текущий Array не имеет ровно двух измерений.

ArgumentOutOfRangeException

index1 Либо index2 находится за пределами диапазона допустимых индексов для соответствующего измерения текущегоArray.

Комментарии

GetLowerBound Методы GetUpperBound могут определить, выходит ли любой из индексов из границ.

Этот метод является операцией O(1).

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

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

GetValue(Int32, Int32, Int32)

Исходный код:

Array.cs

Возвращает значение по заданной позиции в трехмерном Arrayформате. Индексы указываются как 32-разрядные целые числа.

public:
 System::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 или index2index3 находится за пределами диапазона допустимых индексов для соответствующего измерения текущего Array.

Комментарии

GetLowerBound Методы GetUpperBound могут определить, выходит ли любой из индексов из границ.

Этот метод является операцией O(1).

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

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

GetValue(Int64, Int64, Int64)

Исходный код:

Array.cs

Возвращает значение по заданной позиции в трехмерном Arrayформате. Индексы указываются как 64-разрядные целые числа.

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

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

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формате.

Исключения

ArgumentException

Текущий Array не имеет ровно трех измерений.

ArgumentOutOfRangeException

index1 или index2index3 находится за пределами диапазона допустимых индексов для соответствующего измерения текущего Array.

Комментарии

GetLowerBound Методы GetUpperBound могут определить, выходит ли любой из индексов из границ.

Этот метод является операцией O(1).

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

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