Array.SetValue Метод

Ссылка

Определение

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

Сборка:: 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 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

SetValue(Object, Int32)

Исходный код:: 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 элементу массива типов значений, все поля элемента инициализируются нулем. Значение элемента не является пустой ссылкой и не может быть найдено путем поиска пустой ссылки.

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

SetValue(Object, Int32[])

Исходный код:: 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).

Примечание

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

SetValue(Object, Int64[])

Исходный код:: 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

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

SetValue(Object, Int32, Int32)

Исходный код:: 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.

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

SetValue(Object, Int64, Int64)

Исходный код:: 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 используется для назначения null элементу массива типов значений, все поля элемента инициализируются нулевым значением. Значение элемента не является пустой ссылкой и не может быть найдено путем поиска пустой ссылки.

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

SetValue(Object, Int32, Int32, Int32)

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

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

SetValue(Object, Int64, Int64, Int64)

Исходный код:: 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

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

SetValue(Object, Int64)

Исходный код:: 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.

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:

Открыть проблему с документацией Отзыв о продукте

Поделиться через

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)

Параметры

Исключения

Комментарии

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

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