Array.SetValue Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

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

Aşırı Yüklemeler

Name	Description
SetValue(Object, Int32)	bir değeri, tek boyutlu Arrayiçinde belirtilen konumdaki öğesine ayarlar. Dizin 32 bit tamsayı olarak belirtilir.
SetValue(Object, Int32[])	Çok boyutlu Arrayiçinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 32 bit tamsayılardan oluşan bir dizi olarak belirtilir.
SetValue(Object, Int64[])	Çok boyutlu Arrayiçinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 64 bit tamsayılardan oluşan bir dizi olarak belirtilir.
SetValue(Object, Int32, Int32)	İki boyutlu Arrayiçinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 32 bit tamsayılar olarak belirtilir.
SetValue(Object, Int64, Int64)	İki boyutlu Arrayiçinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 64 bit tamsayılar olarak belirtilir.
SetValue(Object, Int32, Int32, Int32)	üç boyutlu Arrayiçinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 32 bit tamsayılar olarak belirtilir.
SetValue(Object, Int64, Int64, Int64)	üç boyutlu Arrayiçinde 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 dizide belirli bir değeri ayarlamayı ve almayı gösterir.

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 bit 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 öğe için yeni değer.

index

Int32

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

Özel durumlar

ArgumentException

Geçerlinin Array tam olarak bir boyutu yok.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne türlenemez.

IndexOutOfRangeException

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

Note

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

Ayrıca bkz.

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

SetValue(Object, Int32[])

Kaynak:

Array.cs

Çok boyutlu Arrayiçinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 32 bit tamsayılardan oluşan bir dizi 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 öğe için yeni değer.

indices

Int32[]

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

Özel durumlar

ArgumentNullException

indices, null'e eşittir.

ArgumentException

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

InvalidCastException

value geçerli Arrayöğesinin öğe türüne türlenemez.

IndexOutOfRangeException

içindeki indices herhangi bir öğe geçerli dizinin ilgili boyutu için geçerli dizin aralığının Arraydışındadır.

Açıklamalar

içindeki indices öğe sayısı içindeki boyut Arraysayısına eşit olmalıdır. Dizideki indices tüm öğeler, çok boyutlu Arrayiçindeki istenen öğenin konumunu toplu olarak 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.

Note

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

Ayrıca bkz.

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

SetValue(Object, Int64[])

Kaynak:

Array.cs

Çok boyutlu Arrayiçinde belirtilen konumdaki öğesine bir değer ayarlar. Dizinler 64 bit 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 öğe için yeni değer.

indices

Int64[]

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

Özel durumlar

ArgumentNullException

indices, null'e eşittir.

ArgumentException

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

InvalidCastException

value geçerli Arrayöğesinin öğe türüne türlenemez.

ArgumentOutOfRangeException

içindeki indices herhangi bir öğe geçerli dizinin ilgili boyutu için geçerli dizin aralığının Arraydışındadır.

Açıklamalar

içindeki indices öğe sayısı içindeki boyut Arraysayısına eşit olmalıdır. Dizideki indices tüm öğeler, çok boyutlu Arrayiçindeki istenen öğenin konumunu toplu olarak 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.

Note

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

Ayrıca bkz.

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

SetValue(Object, Int32, Int32)

Kaynak:

Array.cs

İki boyutlu Arrayiçinde belirtilen konumdaki öğesine 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 öğe için yeni değer.

index1

Int32

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

index2

Int32

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

Özel durumlar

ArgumentException

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

InvalidCastException

value geçerli Arrayöğesinin öğe türüne türlenemez.

IndexOutOfRangeException

veya index1index2 geçerli öğesinin ilgili 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.

Note

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

Ayrıca bkz.

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

SetValue(Object, Int64, Int64)

Kaynak:

Array.cs

İki boyutlu Arrayiçinde belirtilen konumdaki öğesine 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 öğe için yeni değer.

index1

Int64

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

index2

Int64

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

Özel durumlar

ArgumentException

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

InvalidCastException

value geçerli Arrayöğesinin öğe türüne türlenemez.

ArgumentOutOfRangeException

veya index1index2 geçerli öğesinin ilgili 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.

Note

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

Ayrıca bkz.

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

SetValue(Object, Int32, Int32, Int32)

Kaynak:

Array.cs

üç boyutlu Arrayiçinde 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 öğe için yeni değer.

index1

Int32

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

index2

Int32

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

index3

Int32

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

Özel durumlar

ArgumentException

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

InvalidCastException

value geçerli Arrayöğesinin öğe türüne türlenemez.

IndexOutOfRangeException

index1 veya index2index3 geçerli dizinin ilgili 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.

Note

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

Ayrıca bkz.

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

SetValue(Object, Int64, Int64, Int64)

Kaynak:

Array.cs

üç boyutlu Arrayiçinde 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 öğe için yeni değer.

index1

Int64

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

index2

Int64

Ayarlanacağı öğenin ikinci boyut dizinini Array temsil eden 64 bitlik 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ğil.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne türlenemez.

ArgumentOutOfRangeException

index1 veya index2index3 geçerli dizinin ilgili 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.

Note

Değer türleri dizisinin bir öğesine atamak SetValue için kullanılırsanull, öğenin tüm alanları sıfır olarak başlatılır. öğesinin değeri null başvuru değildir ve null başvuru aranarak 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 öğe için yeni değer.

index

Int64

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

Özel durumlar

ArgumentException

Geçerlinin Array tam olarak bir boyutu yok.

InvalidCastException

value geçerli Arrayöğesinin öğe türüne türlenemez.

ArgumentOutOfRangeException

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

Note

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

Ayrıca bkz.

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