Array.GetValue Metod

Definition

Namnområde:: System

Sammansättningar:: mscorlib.dll, System.Runtime.dll

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Runtime.dll

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Hämtar värdet för det angivna elementet i den aktuella Array.

Överlagringar

Name	Description
GetValue(Int32)	Hämtar värdet på den angivna positionen i den endimensionella Array. Indexet anges som ett 32-bitars heltal.
GetValue(Int32[])	Hämtar värdet på den angivna positionen i flerdimensionella Array. Indexen anges som en matris med 32-bitars heltal.
GetValue(Int64)	Hämtar värdet på den angivna positionen i den endimensionella Array. Indexet anges som ett 64-bitars heltal.
GetValue(Int64[])	Hämtar värdet på den angivna positionen i flerdimensionella Array. Indexen anges som en matris med 64-bitars heltal.
GetValue(Int32, Int32)	Hämtar värdet på den angivna positionen i den tvådimensionella Array. Indexen anges som 32-bitars heltal.
GetValue(Int64, Int64)	Hämtar värdet på den angivna positionen i den tvådimensionella Array. Indexen anges som 64-bitars heltal.
GetValue(Int32, Int32, Int32)	Hämtar värdet på den angivna positionen i den tredimensionella Array. Indexen anges som 32-bitars heltal.
GetValue(Int64, Int64, Int64)	Hämtar värdet på den angivna positionen i den tredimensionella Array. Indexen anges som 64-bitars heltal.

Exempel

Följande kodexempel visar hur du anger och hämtar ett specifikt värde i en endimensionell eller flerdimensionell matris.

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)

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Hämtar värdet på den angivna positionen i den endimensionella Array. Indexet anges som ett 32-bitars heltal.

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

Parametrar

index: Int32

Ett 32-bitars heltal som representerar positionen för elementet som Array ska hämtas.

Returer

Object

Värdet på den angivna positionen i den endimensionella Array.

Undantag

ArgumentException

Array Strömmen har inte exakt en dimension.

IndexOutOfRangeException

index ligger utanför intervallet för giltiga index för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om värdet för index ligger utanför gränserna.

Den här metoden är en O(1)-åtgärd.

Se även

Gäller för

GetValue(Int32[])

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Hämtar värdet på den angivna positionen i flerdimensionella Array. Indexen anges som en matris med 32-bitars heltal.

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

Parametrar

indices: Int32[]

En endimensionell matris med 32-bitars heltal som representerar indexen som anger positionen för elementet Array som ska hämtas.

Returer

Object

Värdet vid den angivna positionen i flerdimensionella Array.

Undantag

ArgumentNullException

indices är null.

ArgumentException

Antalet dimensioner i den aktuella Array är inte lika med antalet element i indices.

IndexOutOfRangeException

Alla element i indices ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Antalet element i indices måste vara lika med antalet dimensioner i Array. Alla element i matrisen indices måste gemensamt ange positionen för det önskade elementet i flerdimensionella Array.

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Den här metoden är en O(1)-åtgärd.

Se även

Gäller för

GetValue(Int64)

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Hämtar värdet på den angivna positionen i den endimensionella Array. Indexet anges som ett 64-bitars heltal.

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

Parametrar

index: Int64

Ett 64-bitars heltal som representerar positionen för elementet som Array ska hämtas.

Returer

Object

Värdet på den angivna positionen i den endimensionella Array.

Attribut: ComVisibleAttribute

Undantag

ArgumentException

Array Strömmen har inte exakt en dimension.

ArgumentOutOfRangeException

index ligger utanför intervallet för giltiga index för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om värdet för index ligger utanför gränserna.

Den här metoden är en O(1)-åtgärd.

Se även

Gäller för

GetValue(Int64[])

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Hämtar värdet på den angivna positionen i flerdimensionella Array. Indexen anges som en matris med 64-bitars heltal.

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

Parametrar

indices: Int64[]

En endimensionell matris med 64-bitars heltal som representerar indexen som anger positionen för elementet Array som ska hämtas.

Returer

Object

Värdet vid den angivna positionen i flerdimensionella Array.

Attribut: ComVisibleAttribute

Undantag

ArgumentNullException

indices är null.

ArgumentException

Antalet dimensioner i den aktuella Array är inte lika med antalet element i indices.

ArgumentOutOfRangeException

Alla element i indices ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Antalet element i indices måste vara lika med antalet dimensioner i Array. Alla element i matrisen indices måste gemensamt ange positionen för det önskade elementet i flerdimensionella Array.

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Den här metoden är en O(1)-åtgärd.

Se även

Gäller för

GetValue(Int32, Int32)

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Hämtar värdet på den angivna positionen i den tvådimensionella Array. Indexen anges som 32-bitars heltal.

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

Parametrar

index1: Int32

Ett 32-bitars heltal som representerar det första dimensionsindexet för elementet som Array ska hämtas.

index2: Int32

Ett 32-bitars heltal som representerar det andra dimensionsindexet för elementet som Array ska hämtas.

Returer

Object

Värdet på den angivna positionen i den tvådimensionella Array.

Undantag

ArgumentException

Array Strömmen har inte exakt två dimensioner.

IndexOutOfRangeException

Antingen index1 eller index2 ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Den här metoden är en O(1)-åtgärd.

Se även

Gäller för

GetValue(Int64, Int64)

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Hämtar värdet på den angivna positionen i den tvådimensionella Array. Indexen anges som 64-bitars heltal.

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

Parametrar

index1: Int64

Ett 64-bitars heltal som representerar det första dimensionsindexet för elementet som Array ska hämtas.

index2: Int64

Ett 64-bitars heltal som representerar det andra dimensionsindexet för elementet som Array ska hämtas.

Returer

Object

Värdet på den angivna positionen i den tvådimensionella Array.

Attribut: ComVisibleAttribute

Undantag

ArgumentException

Array Strömmen har inte exakt två dimensioner.

ArgumentOutOfRangeException

Antingen index1 eller index2 ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Den här metoden är en O(1)-åtgärd.

Se även

Gäller för

GetValue(Int32, Int32, Int32)

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Hämtar värdet på den angivna positionen i den tredimensionella Array. Indexen anges som 32-bitars heltal.

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

Parametrar

index1: Int32

Ett 32-bitars heltal som representerar det första dimensionsindexet för elementet som Array ska hämtas.

index2: Int32

Ett 32-bitars heltal som representerar det andra dimensionsindexet för elementet som Array ska hämtas.

index3: Int32

Ett 32-bitars heltal som representerar det tredje dimensionsindexet för elementet som Array ska hämtas.

Returer

Object

Värdet på den angivna positionen i den tredimensionella Array.

Undantag

ArgumentException

Array Strömmen har inte exakt tre dimensioner.

IndexOutOfRangeException

index1 eller index2index3 ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Den här metoden är en O(1)-åtgärd.

Se även

Gäller för

GetValue(Int64, Int64, Int64)

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Källa:: Array.cs

Hämtar värdet på den angivna positionen i den tredimensionella Array. Indexen anges som 64-bitars heltal.

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

Parametrar

index1: Int64

Ett 64-bitars heltal som representerar det första dimensionsindexet för elementet som Array ska hämtas.

index2: Int64

Ett 64-bitars heltal som representerar det andra dimensionsindexet för elementet som Array ska hämtas.

index3: Int64

Ett 64-bitars heltal som representerar det tredje dimensionsindexet för elementet som Array ska hämtas.

Returer

Object

Värdet på den angivna positionen i den tredimensionella Array.

Attribut: ComVisibleAttribute

Undantag

ArgumentException

Array Strömmen har inte exakt tre dimensioner.

ArgumentOutOfRangeException

index1 eller index2index3 ligger utanför intervallet för giltiga index för motsvarande dimension för den aktuella Array.

Kommentarer

Metoderna GetLowerBound och GetUpperBound kan avgöra om något av indexen ligger utanför gränserna.

Den här metoden är en O(1)-åtgärd.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?