Array.SetValue Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Geçerli Array içindeki belirtilen öğeyi belirtilen değere ayarlar.

Aşırı Yüklemeler

SetValue(Object, Int32)	Bir değeri, tek boyutlu Arrayiçinde belirtilen konumdaki öğesine ayarlar. Dizin 32 bitlik bir tamsayı olarak belirtilir.
SetValue(Object, Int32[])	Öğeye çok boyutlu Arrayiçinde belirtilen konumda bir değer ayarlar. Dizinler 32 bitlik tamsayı dizisi olarak belirtilir.
SetValue(Object, Int64[])	Öğeye çok boyutlu Arrayiçinde belirtilen konumda bir değer ayarlar. Dizinler 64 bitlik tamsayılardan oluşan bir dizi olarak belirtilir.
SetValue(Object, Int32, Int32)	öğesine iki boyutlu Arrayiçinde belirtilen konumda bir değer ayarlar. Dizinler, 32 bit tamsayılar olarak belirtilir.
SetValue(Object, Int64, Int64)	öğesine iki boyutlu Arrayiçinde belirtilen konumda bir değer ayarlar. Dizinler 64 bit tamsayılar olarak belirtilir.
SetValue(Object, Int32, Int32, Int32)	Üç boyutlu Arrayöğesinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler, 32 bit tamsayılar olarak belirtilir.
SetValue(Object, Int64, Int64, Int64)	Üç boyutlu Arrayöğesinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 64 bit tamsayılar olarak belirtilir.
SetValue(Object, Int64)	Bir değeri, tek boyutlu Arrayiçinde belirtilen konumdaki öğesine ayarlar. Dizin 64 bit tamsayı olarak belirtilir.

Örnekler

Aşağıdaki kod örneği, tek boyutlu veya çok boyutlu bir dizideki belirli bir değerin nasıl ayarlanacağını veya alınacağını göstermektedir.

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)

Kaynak:

Array.cs

Bir değeri, tek boyutlu Arrayiçinde belirtilen konumdaki öğesine ayarlar. Dizin 32 bitlik bir tamsayı olarak belirtilir.

public:
 void SetValue(System::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)

Parametreler

value

Object

Belirtilen öğenin yeni değeri.

index

Int32

Ayarlanacağı öğenin konumunu Array temsil eden 32 bitlik bir tamsayı.

Özel durumlar

ArgumentException

Geçerli tam Array olarak bir boyuta sahip değil.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne yayınlanamaz.

IndexOutOfRangeException

index geçerli için geçerli dizin aralığının Arraydışındadır.

Açıklamalar

GetLowerBound ve GetUpperBound yöntemleri değerinin index sınırların dışında olup olmadığını belirleyebilir.

Dönüştürmeler hakkında daha fazla bilgi için bkz Convert. .

Bu yöntem bir O(1) işlemidir.

Not

Değer türleri dizisinin bir öğesine atamak null için kullanılırsaSetValue, öğenin tüm alanları sıfır olarak başlatılır. Öğenin değeri bir null başvuru değildir ve null başvuru araması yapılarak bulunamaz.

Ayrıca bkz.

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int32[])

Kaynak:

Array.cs

Öğeye çok boyutlu Arrayiçinde belirtilen konumda bir değer ayarlar. Dizinler 32 bitlik tamsayı dizisi olarak belirtilir.

public:
 void SetValue(System::Object ^ value, ... cli::array <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())

Parametreler

value

Object

Belirtilen öğenin yeni değeri.

indices

Int32[]

Ayarlanacağı öğenin konumunu belirten dizinleri temsil eden 32 bitlik tamsayılardan oluşan tek boyutlu bir dizi.

Özel durumlar

ArgumentNullException

indices, null değeridir.

ArgumentException

Geçerli Array içindeki boyut sayısı, içindeki indicesöğelerin sayısına eşit değildir.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne yayınlanamaz.

IndexOutOfRangeException

içindeki indices herhangi bir öğe, geçerli Arrayöğesinin ilgili boyutu için geçerli dizin aralığının dışındadır.

Açıklamalar

içindeki öğe sayısı içindeki indices boyut Arraysayısına eşit olmalıdır. Dizideki indices tüm öğeler, istenen öğenin çok boyutlu Arrayiçindeki konumunu topluca belirtmelidir.

GetLowerBound ve GetUpperBound yöntemleri dizideki indices değerlerden herhangi birinin sınırların dışında olup olmadığını belirleyebilir.

Dönüştürmeler hakkında daha fazla bilgi için bkz Convert. .

Bu yöntem bir O(1) işlemidir.

Not

Değer türleri dizisinin bir öğesine atamak null için kullanılırsaSetValue, öğenin tüm alanları sıfır olarak başlatılır. Öğenin değeri bir null başvuru değildir ve null başvuru araması yapılarak bulunamaz.

Ayrıca bkz.

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int64[])

Kaynak:

Array.cs

Öğeye çok boyutlu Arrayiçinde belirtilen konumda bir değer ayarlar. Dizinler 64 bitlik tamsayılardan oluşan bir dizi olarak belirtilir.

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

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

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

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

Parametreler

value

Object

Belirtilen öğenin yeni değeri.

indices

Int64[]

Ayarlanacağı öğenin konumunu belirten dizinleri temsil eden 64 bitlik tamsayılardan oluşan tek boyutlu bir dizi.

Özel durumlar

ArgumentNullException

indices, null değeridir.

ArgumentException

Geçerli Array içindeki boyut sayısı, içindeki indicesöğelerin sayısına eşit değildir.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne yayınlanamaz.

ArgumentOutOfRangeException

içindeki indices herhangi bir öğe, geçerli Arrayöğesinin ilgili boyutu için geçerli dizin aralığının dışındadır.

Açıklamalar

içindeki öğe sayısı içindeki indices boyut Arraysayısına eşit olmalıdır. Dizideki indices tüm öğeler, istenen öğenin çok boyutlu Arrayiçindeki konumunu topluca belirtmelidir.

GetLowerBound ve GetUpperBound yöntemleri dizideki indices değerlerden herhangi birinin sınırların dışında olup olmadığını belirleyebilir.

Dönüştürmeler hakkında daha fazla bilgi için bkz Convert. .

Bu yöntem bir O(1) işlemidir.

Not

Değer türleri dizisinin bir öğesine atamak null için kullanılırsaSetValue, öğenin tüm alanları sıfır olarak başlatılır. Öğenin değeri bir null başvuru değildir ve null başvuru araması yapılarak bulunamaz.

Ayrıca bkz.

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int32, Int32)

Kaynak:

Array.cs

öğesine iki boyutlu Arrayiçinde belirtilen konumda bir değer ayarlar. Dizinler, 32 bit tamsayılar olarak belirtilir.

public:
 void SetValue(System::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)

Parametreler

value

Object

Belirtilen öğenin yeni değeri.

index1

Int32

Ayarlanacağı öğenin ilk boyut dizinini Array temsil eden 32 bitlik bir tamsayı.

index2

Int32

Ayarlanacağı öğenin ikinci boyut dizinini Array temsil eden 32 bitlik bir tamsayı.

Özel durumlar

ArgumentException

Geçerli tam Array olarak iki boyuta sahip değildir.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne yayınlanamaz.

IndexOutOfRangeException

index1 veya index2 geçerli boyutu için geçerli dizin aralığının Arraydışındadır.

Açıklamalar

GetLowerBound ve GetUpperBound yöntemleri dizinlerden herhangi birinin sınırların dışında olup olmadığını belirleyebilir.

Dönüştürmeler hakkında daha fazla bilgi için bkz Convert. .

Bu yöntem bir O(1) işlemidir.

Not

Değer türleri dizisinin bir öğesine atamak null için kullanılırsaSetValue, öğenin tüm alanları sıfır olarak başlatılır. Öğenin değeri bir null başvuru değildir ve null başvuru araması yapılarak bulunamaz.

Ayrıca bkz.

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int64, Int64)

Kaynak:

Array.cs

öğesine iki boyutlu Arrayiçinde belirtilen konumda bir değer ayarlar. Dizinler 64 bit tamsayılar olarak belirtilir.

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

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

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

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

Parametreler

value

Object

Belirtilen öğenin yeni değeri.

index1

Int64

Ayarlanacağı öğenin ilk boyut dizinini Array temsil eden 64 bitlik bir tamsayı.

index2

Int64

Ayarlanacağı öğenin ikinci boyut dizinini Array temsil eden 64 bitlik bir tamsayı.

Özel durumlar

ArgumentException

Geçerli tam Array olarak iki boyuta sahip değildir.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne yayınlanamaz.

ArgumentOutOfRangeException

index1 veya index2 geçerli boyutu için geçerli dizin aralığının Arraydışındadır.

Açıklamalar

GetLowerBound ve GetUpperBound yöntemleri dizinlerden herhangi birinin sınırların dışında olup olmadığını belirleyebilir.

Dönüştürmeler hakkında daha fazla bilgi için bkz Convert. .

Bu yöntem bir O(1) işlemidir.

Not

Değer türleri dizisinin bir öğesine atamak null için kullanılırsaSetValue, öğenin tüm alanları sıfır olarak başlatılır. Öğenin değeri bir null başvuru değildir ve null başvuru araması yapılarak bulunamaz.

Ayrıca bkz.

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int32, Int32, Int32)

Kaynak:

Array.cs

Üç boyutlu Arrayöğesinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler, 32 bit tamsayılar olarak belirtilir.

public:
 void SetValue(System::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)

Parametreler

value

Object

Belirtilen öğenin yeni değeri.

index1

Int32

Ayarlanacağı öğenin ilk boyut dizinini Array temsil eden 32 bitlik bir tamsayı.

index2

Int32

Ayarlanacağı öğenin ikinci boyut dizinini Array temsil eden 32 bitlik bir tamsayı.

index3

Int32

Ayarlanacağı öğenin üçüncü boyut dizinini Array temsil eden 32 bitlik bir tamsayı.

Özel durumlar

ArgumentException

Geçerli tam Array olarak üç boyuta sahip değildir.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne yayınlanamaz.

IndexOutOfRangeException

index1 veya index2index3 geçerli Arrayboyutu için geçerli dizin aralığının dışındadır.

Açıklamalar

GetLowerBound ve GetUpperBound yöntemleri dizinlerden herhangi birinin sınırların dışında olup olmadığını belirleyebilir.

Dönüştürmeler hakkında daha fazla bilgi için bkz Convert. .

Bu yöntem bir O(1) işlemidir.

Not

Değer türleri dizisinin bir öğesine atamak null için kullanılırsaSetValue, öğenin tüm alanları sıfır olarak başlatılır. Öğenin değeri bir null başvuru değildir ve null başvuru araması yapılarak bulunamaz.

Ayrıca bkz.

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int64, Int64, Int64)

Kaynak:

Array.cs

Üç boyutlu Arrayöğesinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 64 bit tamsayılar olarak belirtilir.

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

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

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

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

Parametreler

value

Object

Belirtilen öğenin yeni değeri.

index1

Int64

Ayarlanacağı öğenin ilk boyut dizinini Array temsil eden 64 bitlik bir tamsayı.

index2

Int64

Ayarlanacağı öğenin ikinci boyut dizinini Array temsil eden 64 bitlik bir tamsayı.

index3

Int64

Ayarlanacağı öğenin üçüncü boyut dizinini Array temsil eden 64 bitlik bir tamsayı.

Özel durumlar

ArgumentException

Geçerli tam Array olarak üç boyuta sahip değildir.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne yayınlanamaz.

ArgumentOutOfRangeException

index1 veya index2index3 geçerli Arrayboyutu için geçerli dizin aralığının dışındadır.

Açıklamalar

GetLowerBound ve GetUpperBound yöntemleri dizinlerden herhangi birinin sınırların dışında olup olmadığını belirleyebilir.

Dönüştürmeler hakkında daha fazla bilgi için bkz Convert. .

Bu yöntem bir O(1) işlemidir.

Not

Değer türleri dizisinin bir öğesine atamak null için kullanılırsaSetValue, öğenin tüm alanları sıfır olarak başlatılır. Öğenin değeri bir null başvuru değildir ve null başvuru araması yapılarak bulunamaz.

Ayrıca bkz.

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue

SetValue(Object, Int64)

Kaynak:

Array.cs

Bir değeri, tek boyutlu Arrayiçinde belirtilen konumdaki öğesine ayarlar. Dizin 64 bit tamsayı olarak belirtilir.

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

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

member this.SetValue : obj * int64 -> unit

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

Parametreler

value

Object

Belirtilen öğenin yeni değeri.

index

Int64

Ayarlanacağı öğenin konumunu Array temsil eden 64 bitlik bir tamsayı.

Özel durumlar

ArgumentException

Geçerli tam Array olarak bir boyuta sahip değil.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne yayınlanamaz.

ArgumentOutOfRangeException

index geçerli için geçerli dizin aralığının Arraydışındadır.

Açıklamalar

GetLowerBound ve GetUpperBound yöntemleri değerinin index sınırların dışında olup olmadığını belirleyebilir.

Dönüştürmeler hakkında daha fazla bilgi için bkz Convert. .

Bu yöntem bir O(1) işlemidir.

Not

Değer türleri dizisinin bir öğesine atamak null için kullanılırsaSetValue, öğenin tüm alanları sıfır olarak başlatılır. Öğenin değeri bir null başvuru değildir ve null başvuru araması yapılarak bulunamaz.

Ayrıca bkz.

• GetLowerBound(Int32)
• GetUpperBound(Int32)
• GetValue