Array.GetValue Methode

Definitie

Naamruimte:: System

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly's:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt de waarde van het opgegeven element in de huidige Arrayopgehaald.

Overloads

Name	Description
GetValue(Int32)	Hiermee haalt u de waarde op de opgegeven positie in de eendimensionale positie op Array. De index wordt opgegeven als een 32-bits geheel getal.
GetValue(Int32[])	Hiermee haalt u de waarde op de opgegeven positie in de multidimensionale Array. De indexen worden opgegeven als een matrix van 32-bits gehele getallen.
GetValue(Int64)	Hiermee haalt u de waarde op de opgegeven positie in de eendimensionale positie op Array. De index wordt opgegeven als een 64-bits geheel getal.
GetValue(Int64[])	Hiermee haalt u de waarde op de opgegeven positie in de multidimensionale Array. De indexen worden opgegeven als een matrix van 64-bits gehele getallen.
GetValue(Int32, Int32)	Hiermee haalt u de waarde op de opgegeven positie in de tweedimensionale positie op Array. De indexen worden opgegeven als 32-bits gehele getallen.
GetValue(Int64, Int64)	Hiermee haalt u de waarde op de opgegeven positie in de tweedimensionale positie op Array. De indexen worden opgegeven als 64-bits gehele getallen.
GetValue(Int32, Int32, Int32)	Hiermee haalt u de waarde op de opgegeven positie in de driedimensionale positie op Array. De indexen worden opgegeven als 32-bits gehele getallen.
GetValue(Int64, Int64, Int64)	Hiermee haalt u de waarde op de opgegeven positie in de driedimensionale positie op Array. De indexen worden opgegeven als 64-bits gehele getallen.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een specifieke waarde kunt instellen en ophalen in een eendimensionale of multidimensionale matrix.

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)

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Hiermee haalt u de waarde op de opgegeven positie in de eendimensionale positie op Array. De index wordt opgegeven als een 32-bits geheel getal.

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

Parameters

index: Int32

Een 32-bits geheel getal dat de positie van het Array element aangeeft dat moet worden get.

Retouren

Object

De waarde op de opgegeven positie in de eendimensionale Arraypositie.

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies één dimensie.

IndexOutOfRangeException

index valt buiten het bereik van geldige indexen voor de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of de waarde index buiten de grenzen valt.

Deze methode is een O(1)-bewerking.

Zie ook

Van toepassing op

GetValue(Int32[])

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Hiermee haalt u de waarde op de opgegeven positie in de multidimensionale Array. De indexen worden opgegeven als een matrix van 32-bits gehele getallen.

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

Parameters

indices: Int32[]

Een eendimensionale matrix van 32-bits gehele getallen die de indexen vertegenwoordigen die de positie van het Array element aangeven.

Retouren

Object

De waarde op de opgegeven positie in de multidimensionale Array.

Uitzonderingen

ArgumentNullException

indices is null.

ArgumentException

Het aantal dimensies in de huidige Array is niet gelijk aan het aantal elementen in indices.

IndexOutOfRangeException

Elk element valt indices buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidige Array.

Opmerkingen

Het aantal elementen moet indices gelijk zijn aan het aantal dimensies in de Array. Alle elementen in de indices matrix moeten gezamenlijk de positie van het gewenste element in het multidimensionale Arrayelement opgeven.

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Deze methode is een O(1)-bewerking.

Zie ook

Van toepassing op

GetValue(Int64)

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Hiermee haalt u de waarde op de opgegeven positie in de eendimensionale positie op Array. De index wordt opgegeven als een 64-bits geheel getal.

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

Parameters

index: Int64

Een 64-bits geheel getal dat de positie van het Array element aangeeft dat moet worden get.

Retouren

Object

De waarde op de opgegeven positie in de eendimensionale Arraypositie.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies één dimensie.

ArgumentOutOfRangeException

index valt buiten het bereik van geldige indexen voor de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of de waarde index buiten de grenzen valt.

Deze methode is een O(1)-bewerking.

Zie ook

Van toepassing op

GetValue(Int64[])

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Hiermee haalt u de waarde op de opgegeven positie in de multidimensionale Array. De indexen worden opgegeven als een matrix van 64-bits gehele getallen.

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

Parameters

indices: Int64[]

Een eendimensionale matrix van 64-bits gehele getallen die de indexen vertegenwoordigen die de positie van het Array element aangeven.

Retouren

Object

De waarde op de opgegeven positie in de multidimensionale Array.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ArgumentNullException

indices is null.

ArgumentException

Het aantal dimensies in de huidige Array is niet gelijk aan het aantal elementen in indices.

ArgumentOutOfRangeException

Elk element valt indices buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Deze methode is een O(1)-bewerking.

Zie ook

Van toepassing op

GetValue(Int32, Int32)

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Hiermee haalt u de waarde op de opgegeven positie in de tweedimensionale positie op Array. De indexen worden opgegeven als 32-bits gehele getallen.

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

Parameters

index1: Int32

Een 32-bits geheel getal dat de eerste dimensie-index van het Array element vertegenwoordigt dat moet worden get.

index2: Int32

Een 32-bits geheel getal dat de tweede dimensie-index van het Array element vertegenwoordigt om op te halen.

Retouren

Object

De waarde op de opgegeven positie in de tweedimensionale Array.

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies twee dimensies.

IndexOutOfRangeException

Of index1 valt buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidigeindex2.Array

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Deze methode is een O(1)-bewerking.

Zie ook

Van toepassing op

GetValue(Int64, Int64)

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Hiermee haalt u de waarde op de opgegeven positie in de tweedimensionale positie op Array. De indexen worden opgegeven als 64-bits gehele getallen.

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

Parameters

index1: Int64

Een 64-bits geheel getal dat de eerste dimensie-index van het Array element vertegenwoordigt om op te halen.

index2: Int64

Een 64-bits geheel getal dat de tweede dimensie-index van het Array element vertegenwoordigt om op te halen.

Retouren

Object

De waarde op de opgegeven positie in de tweedimensionale Array.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies twee dimensies.

ArgumentOutOfRangeException

Of index1 valt buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidigeindex2.Array

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Deze methode is een O(1)-bewerking.

Zie ook

Van toepassing op

GetValue(Int32, Int32, Int32)

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Hiermee haalt u de waarde op de opgegeven positie in de driedimensionale positie op Array. De indexen worden opgegeven als 32-bits gehele getallen.

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

Parameters

index1: Int32

Een 32-bits geheel getal dat de eerste dimensie-index van het Array element vertegenwoordigt dat moet worden get.

index2: Int32

Een 32-bits geheel getal dat de tweede dimensie-index van het Array element vertegenwoordigt om op te halen.

index3: Int32

Een 32-bits geheel getal dat de index van de derde dimensie van het Array element vertegenwoordigt.

Retouren

Object

De waarde op de opgegeven positie in de driedimensionale Array.

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies drie dimensies.

IndexOutOfRangeException

index1 of index2index3 valt buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Deze methode is een O(1)-bewerking.

Zie ook

Van toepassing op

GetValue(Int64, Int64, Int64)

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Bron:: Array.cs

Hiermee haalt u de waarde op de opgegeven positie in de driedimensionale positie op Array. De indexen worden opgegeven als 64-bits gehele getallen.

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

Parameters

index1: Int64

Een 64-bits geheel getal dat de eerste dimensie-index van het Array element vertegenwoordigt om op te halen.

index2: Int64

Een 64-bits geheel getal dat de tweede dimensie-index van het Array element vertegenwoordigt om op te halen.

index3: Int64

Een 64-bits geheel getal dat de index van de derde dimensie van het Array element vertegenwoordigt.

Retouren

Object

De waarde op de opgegeven positie in de driedimensionale Array.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ArgumentException

De huidige Array heeft niet precies drie dimensies.

ArgumentOutOfRangeException

index1 of index2index3 valt buiten het bereik van geldige indexen voor de bijbehorende dimensie van de huidige Array.

Opmerkingen

De GetLowerBound en GetUpperBound methoden kunnen bepalen of een van de indexen buiten de grenzen valt.

Deze methode is een O(1)-bewerking.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?