Array.GetValue Yöntem

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Geçerli Arrayöğesinde belirtilen öğenin değerini alır.

Aşırı Yüklemeler

GetValue(Int32)

Değeri tek boyutlu Arrayiçinde belirtilen konumda alır. Dizin 32 bitlik bir tamsayı olarak belirtilir.
GetValue(Int32[])

Çok boyutlu Arrayiçinde belirtilen konumdaki değeri alır. Dizinler 32 bitlik tamsayı dizisi olarak belirtilir.
GetValue(Int64)

Değeri tek boyutlu Arrayiçinde belirtilen konumda alır. Dizin 64 bit tamsayı olarak belirtilir.
GetValue(Int64[])

Çok boyutlu Arrayiçinde belirtilen konumdaki değeri alır. Dizinler 64 bitlik tamsayılardan oluşan bir dizi olarak belirtilir.
GetValue(Int32, Int32)

İki boyutlu Arrayiçinde belirtilen konumdaki değeri alır. Dizinler, 32 bit tamsayılar olarak belirtilir.
GetValue(Int64, Int64)

İki boyutlu Arrayiçinde belirtilen konumdaki değeri alır. Dizinler 64 bit tamsayılar olarak belirtilir.
GetValue(Int32, Int32, Int32)

Değeri üç boyutlu Arrayiçinde belirtilen konumda alır. Dizinler, 32 bit tamsayılar olarak belirtilir.
GetValue(Int64, Int64, Int64)

Değeri üç boyutlu Arrayiçinde belirtilen konumda alır. Dizinler 64 bit tamsayılar 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

GetValue(Int32)

Değeri tek boyutlu Arrayiçinde belirtilen konumda alır. Dizin 32 bitlik bir tamsayı olarak belirtilir.

public:
 System::Object ^ GetValue(int index);
public object GetValue (int index);
public object? GetValue (int index);
member this.GetValue : int -> obj
Public Function GetValue (index As Integer) As Object

Parametreler

index
Int32

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

Döndürülenler

Object

Tek boyutlu Arrayiçinde belirtilen konumdaki değer.

Özel durumlar

ArgumentException

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

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.

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

Ayrıca bkz.

Şunlara uygulanır

GetValue(Int32[])

Çok boyutlu Arrayiçinde belirtilen konumdaki değeri alır. Dizinler 32 bitlik tamsayı dizisi olarak belirtilir.

public:
 System::Object ^ GetValue(... cli::array <int> ^ indices);
public object GetValue (params int[] indices);
public object? GetValue (params int[] indices);
member this.GetValue : int[] -> obj
Public Function GetValue (ParamArray indices As Integer()) As Object

Parametreler

indices
Int32[]

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

Döndürülenler

Object

Çok boyutlu Arrayiçinde belirtilen konumdaki değer.

Özel durumlar

ArgumentNullException

indices, null değeridir.

ArgumentException

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

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 dizinlerden herhangi birinin sınırların dışında olup olmadığını belirleyebilir.

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

Ayrıca bkz.

Şunlara uygulanır

GetValue(Int64)

Değeri tek boyutlu Arrayiçinde belirtilen konumda alır. Dizin 64 bit tamsayı olarak belirtilir.

public:
 System::Object ^ GetValue(long index);
public object? GetValue (long index);
public object GetValue (long index);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (long index);
member this.GetValue : int64 -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 -> obj
Public Function GetValue (index As Long) As Object

Parametreler

index
Int64

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

Döndürülenler

Object

Tek boyutlu Arrayiçinde belirtilen konumdaki değer.

Öznitelikler
ComVisibleAttribute

Özel durumlar

ArgumentException

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

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.

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

Ayrıca bkz.

Şunlara uygulanır

GetValue(Int64[])

Çok boyutlu Arrayiçinde belirtilen konumdaki değeri alır. Dizinler 64 bitlik tamsayılardan oluşan bir dizi olarak belirtilir.

public:
 System::Object ^ GetValue(... cli::array <long> ^ indices);
public object? GetValue (params long[] indices);
public object GetValue (params long[] indices);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (params long[] indices);
member this.GetValue : int64[] -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64[] -> obj
Public Function GetValue (ParamArray indices As Long()) As Object

Parametreler

indices
Int64[]

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

Döndürülenler

Object

Çok boyutlu Arrayiçinde belirtilen konumdaki değer.

Öznitelikler
ComVisibleAttribute

Özel durumlar

ArgumentNullException

indices, null değeridir.

ArgumentException

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

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 dizinlerden herhangi birinin sınırların dışında olup olmadığını belirleyebilir.

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

Ayrıca bkz.

Şunlara uygulanır

GetValue(Int32, Int32)

İki boyutlu Arrayiçinde belirtilen konumdaki değeri alır. Dizinler, 32 bit tamsayılar olarak belirtilir.

public:
 System::Object ^ GetValue(int index1, int index2);
public object? GetValue (int index1, int index2);
public object GetValue (int index1, int index2);
member this.GetValue : int * int -> obj
Public Function GetValue (index1 As Integer, index2 As Integer) As Object

Parametreler

index1
Int32

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

index2
Int32

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

Döndürülenler

Object

İki boyutlu Arrayiçinde belirtilen konumdaki değer.

Özel durumlar

ArgumentException

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

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.

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

Ayrıca bkz.

Şunlara uygulanır

GetValue(Int64, Int64)

İki boyutlu Arrayiçinde belirtilen konumdaki değeri alır. Dizinler 64 bit tamsayılar olarak belirtilir.

public:
 System::Object ^ GetValue(long index1, long index2);
public object? GetValue (long index1, long index2);
public object GetValue (long index1, long index2);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (long index1, long index2);
member this.GetValue : int64 * int64 -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 * int64 -> obj
Public Function GetValue (index1 As Long, index2 As Long) As Object

Parametreler

index1
Int64

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

index2
Int64

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

Döndürülenler

Object

İki boyutlu Arrayiçinde belirtilen konumdaki değer.

Öznitelikler
ComVisibleAttribute

Özel durumlar

ArgumentException

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

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.

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

Ayrıca bkz.

Şunlara uygulanır

GetValue(Int32, Int32, Int32)

Değeri üç boyutlu Arrayiçinde belirtilen konumda alır. Dizinler, 32 bit tamsayılar olarak belirtilir.

public:
 System::Object ^ GetValue(int index1, int index2, int index3);
public object? GetValue (int index1, int index2, int index3);
public object GetValue (int index1, int index2, int index3);
member this.GetValue : int * int * int -> obj
Public Function GetValue (index1 As Integer, index2 As Integer, index3 As Integer) As Object

Parametreler

index1
Int32

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

index2
Int32

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

index3
Int32

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

Döndürülenler

Object

Üç boyutlu Arrayiçinde belirtilen konumdaki değer.

Özel durumlar

ArgumentException

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

IndexOutOfRangeException

index1 veya index2 index3 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.

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

Ayrıca bkz.

Şunlara uygulanır

GetValue(Int64, Int64, Int64)

Değeri üç boyutlu Arrayiçinde belirtilen konumda alır. Dizinler 64 bit tamsayılar olarak belirtilir.

public:
 System::Object ^ GetValue(long index1, long index2, long index3);
public object? GetValue (long index1, long index2, long index3);
public object GetValue (long index1, long index2, long index3);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (long index1, long index2, long index3);
member this.GetValue : int64 * int64 * int64 -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : int64 * int64 * int64 -> obj
Public Function GetValue (index1 As Long, index2 As Long, index3 As Long) As Object

Parametreler

index1
Int64

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

index2
Int64

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

index3
Int64

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

Döndürülenler

Object

Üç boyutlu Arrayiçinde belirtilen konumdaki değer.

Öznitelikler
ComVisibleAttribute

Özel durumlar

ArgumentException

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

ArgumentOutOfRangeException

index1 veya index2 index3 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.

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

Ayrıca bkz.

Şunlara uygulanır