Array.SetValue Yöntem

Tanım

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
Kaynak:
Array.cs
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);
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

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

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

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.

Şunlara uygulanır

SetValue(Object, Int32[])

Kaynak:
Array.cs
Kaynak:
Array.cs
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);
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

indices, null değeridir.

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

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

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.

Şunlara uygulanır

SetValue(Object, Int64[])

Kaynak:
Array.cs
Kaynak:
Array.cs
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);
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())

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.

Öznitelikler

Özel durumlar

indices, null değeridir.

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

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

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.

Şunlara uygulanır

SetValue(Object, Int32, Int32)

Kaynak:
Array.cs
Kaynak:
Array.cs
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);
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

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

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

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.

Şunlara uygulanır

SetValue(Object, Int64, Int64)

Kaynak:
Array.cs
Kaynak:
Array.cs
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);
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)

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

Öznitelikler

Özel durumlar

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

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

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.

Şunlara uygulanır

SetValue(Object, Int32, Int32, Int32)

Kaynak:
Array.cs
Kaynak:
Array.cs
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);
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

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

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

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.

Şunlara uygulanır

SetValue(Object, Int64, Int64, Int64)

Kaynak:
Array.cs
Kaynak:
Array.cs
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);
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)

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

Öznitelikler

Özel durumlar

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

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

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.

Şunlara uygulanır

SetValue(Object, Int64)

Kaynak:
Array.cs
Kaynak:
Array.cs
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);
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)

Parametreler

value
Object

Belirtilen öğenin yeni değeri.

index
Int64

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

Öznitelikler

Özel durumlar

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

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

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.

Şunlara uygulanır