Array.GetValue Método

  • Referencia

Definición

Espacio de nombres:
System
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Obtiene el valor del elemento especificado de la Array actual.

Sobrecargas

GetValue(Int32)

Obtiene el valor de la posición especificada de la matriz Array unidimensional. El índice se especifica como un entero de 32 bits.
GetValue(Int32[])

Obtiene el valor de la posición especificada de Array multidimensional. Los índices se especifican en forma de una matriz de enteros de 32 bits.
GetValue(Int64)

Obtiene el valor de la posición especificada de la matriz Array unidimensional. El índice se especifica como un entero de 64 bits.
GetValue(Int64[])

Obtiene el valor de la posición especificada de Array multidimensional. Los índices se especifican como matriz de enteros de 64 bits.
GetValue(Int32, Int32)

Obtiene el valor de la posición especificada de la Array bidimensional. Los índices se especifican como enteros de 32 bits.
GetValue(Int64, Int64)

Obtiene el valor de la posición especificada de la Array bidimensional. Los índices se especifican como enteros de 64 bits.
GetValue(Int32, Int32, Int32)

Obtiene el valor de la posición especificada de la Array tridimensional. Los índices se especifican como enteros de 32 bits.
GetValue(Int64, Int64, Int64)

Obtiene el valor de la posición especificada de la Array tridimensional. 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 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)

Obtiene el valor de la posición especificada de la matriz Array unidimensional. 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 elemento Array que se va a obtener.

Devoluciones

Object

Valor de la posición especificada de la matriz Array unidimensional.

Excepciones

ArgumentException

El Array actual no tiene exactamente una dimensión.

IndexOutOfRangeException

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

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[])

Obtiene el valor de la posición especificada de Array multidimensional. Los índices se especifican en forma de 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 elemento Array que se debe obtener.

Devoluciones

Object

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

Excepciones

ArgumentNullException

indices es null.

ArgumentException

El número de dimensiones de la Array actual 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 de la Array actual.

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)

Obtiene el valor de la posición especificada de la matriz Array unidimensional. 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 elemento Array que se va a obtener.

Devoluciones

Object

Valor de la posición especificada de la matriz Array unidimensional.

Atributos
ComVisibleAttribute

Excepciones

ArgumentException

El Array actual no tiene exactamente una dimensión.

ArgumentOutOfRangeException

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

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[])

Obtiene el valor de la posición especificada de Array multidimensional. Los índices se especifican como 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 elemento Array que se va a obtener.

Devoluciones

Object

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

Atributos
ComVisibleAttribute

Excepciones

ArgumentNullException

indices es null.

ArgumentException

El número de dimensiones de la Array actual 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 de la Array actual.

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(Int32, Int32)

Obtiene el valor de la posición especificada de la Array bidimensional. 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 la primera dimensión del elemento Array que se va a obtener.

index2
Int32

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

Devoluciones

Object

Valor de la posición especificada de la matriz bidimensional Array.

Excepciones

ArgumentException

El Array actual no tiene exactamente dos dimensiones.

IndexOutOfRangeException

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

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)

Obtiene el valor de la posición especificada de la Array bidimensional. 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 la primera dimensión del elemento Array que se va a obtener.

index2
Int64

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

Devoluciones

Object

Valor de la posición especificada de la matriz bidimensional Array.

Atributos
ComVisibleAttribute

Excepciones

ArgumentException

El Array actual no tiene exactamente dos dimensiones.

ArgumentOutOfRangeException

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

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)

Obtiene el valor de la posición especificada de la Array tridimensional. 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 la primera dimensión del elemento Array que se va a obtener.

index2
Int32

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

index3
Int32

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

Devoluciones

Object

Valor de la posición especificada de la matriz Array tridimensional.

Excepciones

ArgumentException

El Array actual no tiene exactamente tres dimensiones.

IndexOutOfRangeException

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

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)

Obtiene el valor de la posición especificada de la Array tridimensional. 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 la primera dimensión del elemento Array que se va a obtener.

index2
Int64

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

index3
Int64

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

Devoluciones

Object

Valor de la posición especificada de la matriz Array tridimensional.

Atributos
ComVisibleAttribute

Excepciones

ArgumentException

El Array actual no tiene exactamente tres dimensiones.

ArgumentOutOfRangeException

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

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