Array.SetValue Метод

Определение

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

Сборки:: mscorlib.dll, System.Runtime.dll

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Задает указанный элемент в текущем Array значении.

Перегрузки

Имя	Описание
SetValue(Object, Int32)	Задает значение для элемента в указанной позиции в одномерном Arrayрежиме. Индекс указывается как 32-разрядное целое число.
SetValue(Object, Int32[])	Задает значение для элемента в указанной позиции в многомерном режиме Array. Индексы указываются в виде массива 32-разрядных целых чисел.
SetValue(Object, Int64[])	Задает значение для элемента в указанной позиции в многомерном режиме Array. Индексы указываются в виде массива 64-разрядных целых чисел.
SetValue(Object, Int32, Int32)	Задает значение для элемента в указанной позиции в двухмерном Arrayформате. Индексы указываются как 32-разрядные целые числа.
SetValue(Object, Int64, Int64)	Задает значение для элемента в указанной позиции в двухмерном Arrayформате. Индексы указываются как 64-разрядные целые числа.
SetValue(Object, Int32, Int32, Int32)	Задает значение для элемента в указанной позиции в трехмерном Arrayвиде. Индексы указываются как 32-разрядные целые числа.
SetValue(Object, Int64, Int64, Int64)	Задает значение для элемента в указанной позиции в трехмерном Arrayвиде. Индексы указываются как 64-разрядные целые числа.
SetValue(Object, 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

SetValue(Object, Int32)

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

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

public:
 void SetValue(System::Object ^ value, int index);

public void SetValue(object value, int index);

public void SetValue(object? value, int index);

member this.SetValue : obj * int -> unit

Public Sub SetValue (value As Object, index As Integer)

Параметры

value: Object

Новое значение для указанного элемента.

index: Int32

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

Исключения

ArgumentException

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

InvalidCastException

value невозможно привести к типу элемента текущего Arrayэлемента.

IndexOutOfRangeException

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

Если SetValue используется для назначения null элементу массива типов значений, все поля элемента инициализированы до нуля. Значение элемента не является пустой ссылкой и не может быть найдено путем поиска ссылки null.

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

Применяется к

SetValue(Object, Int32[])

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

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

public:
 void SetValue(System::Object ^ value, ... cli::array <int> ^ indices);

public void SetValue(object value, params int[] indices);

public void SetValue(object? value, params int[] indices);

member this.SetValue : obj * int[] -> unit

Public Sub SetValue (value As Object, ParamArray indices As Integer())

Параметры

value: Object

Новое значение для указанного элемента.

indices: Int32[]

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

Исключения

ArgumentNullException

indices равно null.

ArgumentException

Число измерений в текущем Array не равно числу элементов indicesв .

InvalidCastException

value невозможно привести к типу элемента текущего Arrayэлемента.

IndexOutOfRangeException

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

Число элементов в indices должно быть равно числу Arrayизмерений в . Все элементы в indices массиве должны совместно указывать положение требуемого элемента в многомерном Array.

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

Дополнительные сведения о преобразованиях см. в разделе Convert.

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

Note

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

Применяется к

SetValue(Object, Int64[])

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

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

public:
 void SetValue(System::Object ^ value, ... cli::array <long> ^ indices);

public void SetValue(object? value, params long[] indices);

public void SetValue(object value, params long[] indices);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, params long[] indices);

member this.SetValue : obj * int64[] -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64[] -> unit

Public Sub SetValue (value As Object, ParamArray indices As Long())

Параметры

value: Object

Новое значение для указанного элемента.

indices: Int64[]

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

Атрибуты: ComVisibleAttribute

Исключения

ArgumentNullException

indices равно null.

ArgumentException

Число измерений в текущем Array не равно числу элементов indicesв .

InvalidCastException

value невозможно привести к типу элемента текущего Arrayэлемента.

ArgumentOutOfRangeException

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

Применяется к

SetValue(Object, Int32, Int32)

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

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

public:
 void SetValue(System::Object ^ value, int index1, int index2);

public void SetValue(object? value, int index1, int index2);

public void SetValue(object value, int index1, int index2);

member this.SetValue : obj * int * int -> unit

Public Sub SetValue (value As Object, index1 As Integer, index2 As Integer)

Параметры

value: Object

Новое значение для указанного элемента.

index1: Int32

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

index2: Int32

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

Исключения

ArgumentException

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

InvalidCastException

value невозможно привести к типу элемента текущего Arrayэлемента.

IndexOutOfRangeException

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

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

Применяется к

SetValue(Object, Int64, Int64)

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

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

public:
 void SetValue(System::Object ^ value, long index1, long index2);

public void SetValue(object? value, long index1, long index2);

public void SetValue(object value, long index1, long index2);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, long index1, long index2);

member this.SetValue : obj * int64 * int64 -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 * int64 -> unit

Public Sub SetValue (value As Object, index1 As Long, index2 As Long)

Параметры

value: Object

Новое значение для указанного элемента.

index1: Int64

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

index2: Int64

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

Атрибуты: ComVisibleAttribute

Исключения

ArgumentException

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

InvalidCastException

value невозможно привести к типу элемента текущего Arrayэлемента.

ArgumentOutOfRangeException

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

Применяется к

SetValue(Object, Int32, Int32, Int32)

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

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

public:
 void SetValue(System::Object ^ value, int index1, int index2, int index3);

public void SetValue(object? value, int index1, int index2, int index3);

public void SetValue(object value, int index1, int index2, int index3);

member this.SetValue : obj * int * int * int -> unit

Public Sub SetValue (value As Object, index1 As Integer, index2 As Integer, index3 As Integer)

Параметры

value: Object

Новое значение для указанного элемента.

index1: Int32

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

index2: Int32

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

index3: Int32

32-разрядное целое число, представляющее индекс третьего измерения заданного Array элемента.

Исключения

ArgumentException

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

InvalidCastException

value невозможно привести к типу элемента текущего Arrayэлемента.

IndexOutOfRangeException

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

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

Применяется к

SetValue(Object, Int64, Int64, Int64)

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

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

public:
 void SetValue(System::Object ^ value, long index1, long index2, long index3);

public void SetValue(object? value, long index1, long index2, long index3);

public void SetValue(object value, long index1, long index2, long index3);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, long index1, long index2, long index3);

member this.SetValue : obj * int64 * int64 * int64 -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 * int64 * int64 -> unit

Public Sub SetValue (value As Object, index1 As Long, index2 As Long, index3 As Long)

Параметры

value: Object

Новое значение для указанного элемента.

index1: Int64

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

index2: Int64

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

index3: Int64

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

Атрибуты: ComVisibleAttribute

Исключения

ArgumentException

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

InvalidCastException

value невозможно привести к типу элемента текущего Arrayэлемента.

ArgumentOutOfRangeException

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

Применяется к

SetValue(Object, Int64)

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

Исходный код:: Array.cs

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

public:
 void SetValue(System::Object ^ value, long index);

public void SetValue(object? value, long index);

public void SetValue(object value, long index);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetValue(object value, long index);

member this.SetValue : obj * int64 -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetValue : obj * int64 -> unit

Public Sub SetValue (value As Object, index As Long)

Параметры

value: Object

Новое значение для указанного элемента.

index: Int64

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

Атрибуты: ComVisibleAttribute

Исключения

ArgumentException

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

InvalidCastException

value невозможно привести к типу элемента текущего Arrayэлемента.

ArgumentOutOfRangeException

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

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

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

Array.SetValue Метод

Определение

Перегрузки

Примеры

SetValue(Object, Int32)

Параметры

Исключения

Комментарии

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

Применяется к

SetValue(Object, Int32[])

Параметры

Исключения

Комментарии

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

Применяется к

SetValue(Object, Int64[])

Параметры

Исключения

Комментарии

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

Применяется к

SetValue(Object, Int32, Int32)

Параметры

Исключения

Комментарии

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

Применяется к

SetValue(Object, Int64, Int64)

Параметры

Исключения

Комментарии

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

Применяется к

SetValue(Object, Int32, Int32, Int32)

Параметры

Исключения

Комментарии

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

Применяется к

SetValue(Object, Int64, Int64, Int64)

Параметры

Исключения

Комментарии

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

Применяется к

SetValue(Object, Int64)

Параметры

Исключения

Комментарии

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

Применяется к

Обратная связь