Array.GetValue Método

Definición

Espacio de nombres:: System

Ensamblados:: mscorlib.dll, System.Runtime.dll

Ensamblados:: netstandard.dll, System.Runtime.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene el valor del elemento especificado en el objeto actual Array.

Sobrecargas

Nombre	Description
GetValue(Int32)	Obtiene el valor en la posición especificada en la unidimensional Array. El índice se especifica como un entero de 32 bits.
GetValue(Int32[])	Obtiene el valor en la posición especificada en la multidimensional Array. Los índices se especifican como una matriz de enteros de 32 bits.
GetValue(Int64)	Obtiene el valor en la posición especificada en la unidimensional Array. El índice se especifica como un entero de 64 bits.
GetValue(Int64[])	Obtiene el valor en la posición especificada en la multidimensional Array. Los índices se especifican como una matriz de enteros de 64 bits.
GetValue(Int32, Int32)	Obtiene el valor en la posición especificada en la bidimensional Array. Los índices se especifican como enteros de 32 bits.
GetValue(Int64, Int64)	Obtiene el valor en la posición especificada en la bidimensional Array. Los índices se especifican como enteros de 64 bits.
GetValue(Int32, Int32, Int32)	Obtiene el valor en la posición especificada en la tridimensional Array. Los índices se especifican como enteros de 32 bits.
GetValue(Int64, Int64, Int64)	Obtiene el valor en la posición especificada en la tridimensional Array. Los índices se especifican como enteros de 64 bits.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer y obtener un valor específico en una matriz unidimensional o multidimensional.

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)

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Obtiene el valor en la posición especificada en la unidimensional Array. El índice se especifica como un entero de 32 bits.

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

Parámetros

index: Int32

Entero de 32 bits que representa la posición del Array elemento que se va a obtener.

Devoluciones

Object

Valor en la posición especificada en la unidimensional Array.

Excepciones

ArgumentException

La corriente Array no tiene exactamente una dimensión.

IndexOutOfRangeException

index está fuera del intervalo de índices válidos para el objeto actual Array.

Comentarios

Los GetLowerBound métodos y GetUpperBound pueden determinar si el valor de index está fuera de los límites.

Este método es una operación O(1).

Consulte también

Se aplica a

GetValue(Int32[])

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Obtiene el valor en la posición especificada en la multidimensional Array. Los índices se especifican como una matriz de enteros de 32 bits.

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

Parámetros

indices: Int32[]

Matriz unidimensional de enteros de 32 bits que representan los índices que especifican la posición del Array elemento que se va a obtener.

Devoluciones

Object

Valor en la posición especificada en la multidimensional Array.

Excepciones

ArgumentNullException

indices es null.

ArgumentException

El número de dimensiones del actual Array no es igual al número de elementos de indices.

IndexOutOfRangeException

Cualquier elemento de indices está fuera del intervalo de índices válidos para la dimensión correspondiente del objeto actual Array.

Comentarios

El número de elementos de indices debe ser igual al número de dimensiones de Array. Todos los elementos de la indices matriz deben especificar colectivamente la posición del elemento deseado en el elemento multidimensional Array.

Los GetLowerBound métodos y GetUpperBound pueden determinar si alguno de los índices está fuera de los límites.

Este método es una operación O(1).

Consulte también

Se aplica a

GetValue(Int64)

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Obtiene el valor en la posición especificada en la unidimensional Array. El índice se especifica como un entero de 64 bits.

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

Parámetros

index: Int64

Entero de 64 bits que representa la posición del Array elemento que se va a obtener.

Devoluciones

Object

Valor en la posición especificada en la unidimensional Array.

Atributos: ComVisibleAttribute

Excepciones

ArgumentException

La corriente Array no tiene exactamente una dimensión.

ArgumentOutOfRangeException

index está fuera del intervalo de índices válidos para el objeto actual Array.

Comentarios

Los GetLowerBound métodos y GetUpperBound pueden determinar si el valor de index está fuera de los límites.

Este método es una operación O(1).

Consulte también

Se aplica a

GetValue(Int64[])

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Obtiene el valor en la posición especificada en la multidimensional Array. Los índices se especifican como una matriz de enteros de 64 bits.

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

Parámetros

indices: Int64[]

Matriz unidimensional de enteros de 64 bits que representan los índices que especifican la posición del Array elemento que se va a obtener.

Devoluciones

Object

Valor en la posición especificada en la multidimensional Array.

Atributos: ComVisibleAttribute

Excepciones

ArgumentNullException

indices es null.

ArgumentException

El número de dimensiones del actual Array no es igual al número de elementos de indices.

ArgumentOutOfRangeException

Cualquier elemento de indices está fuera del intervalo de índices válidos para la dimensión correspondiente del objeto actual Array.

Comentarios

Los GetLowerBound métodos y GetUpperBound pueden determinar si alguno de los índices está fuera de los límites.

Este método es una operación O(1).

Consulte también

Se aplica a

GetValue(Int32, Int32)

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Obtiene el valor en la posición especificada en la bidimensional Array. Los índices se especifican como enteros de 32 bits.

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

Parámetros

index1: Int32

Entero de 32 bits que representa el índice de primera dimensión del Array elemento que se va a obtener.

index2: Int32

Entero de 32 bits que representa el índice de segunda dimensión del Array elemento que se va a obtener.

Devoluciones

Object

Valor en la posición especificada en la bidimensional Array.

Excepciones

ArgumentException

La corriente Array no tiene exactamente dos dimensiones.

IndexOutOfRangeException

O index1index2 está fuera del intervalo de índices válidos para la dimensión correspondiente del objeto actual Array.

Comentarios

Los GetLowerBound métodos y GetUpperBound pueden determinar si alguno de los índices está fuera de los límites.

Este método es una operación O(1).

Consulte también

Se aplica a

GetValue(Int64, Int64)

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Obtiene el valor en la posición especificada en la bidimensional Array. Los índices se especifican como enteros de 64 bits.

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

Parámetros

index1: Int64

Entero de 64 bits que representa el índice de primera dimensión del Array elemento que se va a obtener.

index2: Int64

Entero de 64 bits que representa el índice de segunda dimensión del Array elemento que se va a obtener.

Devoluciones

Object

Valor en la posición especificada en la bidimensional Array.

Atributos: ComVisibleAttribute

Excepciones

ArgumentException

La corriente Array no tiene exactamente dos dimensiones.

ArgumentOutOfRangeException

O index1index2 está fuera del intervalo de índices válidos para la dimensión correspondiente del objeto actual Array.

Comentarios

Los GetLowerBound métodos y GetUpperBound pueden determinar si alguno de los índices está fuera de los límites.

Este método es una operación O(1).

Consulte también

Se aplica a

GetValue(Int32, Int32, Int32)

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Obtiene el valor en la posición especificada en la tridimensional Array. Los índices se especifican como enteros de 32 bits.

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

Parámetros

index1: Int32

Entero de 32 bits que representa el índice de primera dimensión del Array elemento que se va a obtener.

index2: Int32

Entero de 32 bits que representa el índice de segunda dimensión del Array elemento que se va a obtener.

index3: Int32

Entero de 32 bits que representa el índice de tercera dimensión del Array elemento que se va a obtener.

Devoluciones

Object

Valor en la posición especificada en la tridimensional Array.

Excepciones

ArgumentException

La corriente Array no tiene exactamente tres dimensiones.

IndexOutOfRangeException

index1 o index2index3 está fuera del intervalo de índices válidos para la dimensión correspondiente del objeto actual Array.

Comentarios

Los GetLowerBound métodos y GetUpperBound pueden determinar si alguno de los índices está fuera de los límites.

Este método es una operación O(1).

Consulte también

Se aplica a

GetValue(Int64, Int64, Int64)

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Source:: Array.cs

Obtiene el valor en la posición especificada en la tridimensional Array. Los índices se especifican como enteros de 64 bits.

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

Parámetros

index1: Int64

Entero de 64 bits que representa el índice de primera dimensión del Array elemento que se va a obtener.

index2: Int64

Entero de 64 bits que representa el índice de segunda dimensión del Array elemento que se va a obtener.

index3: Int64

Entero de 64 bits que representa el índice de tercera dimensión del Array elemento que se va a obtener.

Devoluciones

Object

Valor en la posición especificada en la tridimensional Array.

Atributos: ComVisibleAttribute

Excepciones

ArgumentException

La corriente Array no tiene exactamente tres dimensiones.

ArgumentOutOfRangeException

index1 o index2index3 está fuera del intervalo de índices válidos para la dimensión correspondiente del objeto actual Array.

Comentarios

Los GetLowerBound métodos y GetUpperBound pueden determinar si alguno de los índices está fuera de los límites.

Este método es una operación O(1).

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?