# Array.GetValue Método

## Definição

Obtém o valor do elemento especificado no Array atual.Gets the value of the specified element in the current Array.

## Exemplos

O exemplo de código a seguir demonstra como definir e obter um valor específico em uma matriz unidimensional ou multidimensional.The following code example demonstrates how to set and get a specific value in a one-dimensional or multidimensional array.

``````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

*/
``````
``````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(Int64, Int64, Int64)

Obtém o valor na posição especificada no Array tridimensional.Gets the value at the specified position in the three-dimensional Array. Os índices são especificados como inteiros de 64 bits.The indexes are specified as 64-bit integers.

``````public:
System::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

Um inteiro de 64 bits que representa o índice da primeira dimensão do elemento Array a ser obtido.A 64-bit integer that represents the first-dimension index of the Array element to get.

index2
Int64

Um inteiro de 64 bits que representa o índice da segunda dimensão do elemento Array a ser obtido.A 64-bit integer that represents the second-dimension index of the Array element to get.

index3
Int64

Um inteiro de 64 bits que representa o índice da terceira dimensão do elemento Array a ser obtido.A 64-bit integer that represents the third-dimension index of the Array element to get.

#### Retornos

Object

O valor na posição especificada no Array tridimensional.The value at the specified position in the three-dimensional Array.

Atributos

#### Exceções

O Array atual não tem exatamente três dimensões.The current Array does not have exactly three dimensions.

`index1` ou `index2` ou `index3` está fora do intervalo de índices válidos para a dimensão correspondente do Array atual.`index1` or `index2` or `index3` is outside the range of valid indexes for the corresponding dimension of the current Array.

### Comentários

Os métodos GetLowerBound e GetUpperBound podem determinar se alguns dos índices está fora dos limites.The GetLowerBound and GetUpperBound methods can determine whether any of the indexes is out of bounds.

Este método é uma operação O(1).This method is an O(1) operation.

## GetValue(Int32, Int32, Int32)

Obtém o valor na posição especificada no Array tridimensional.Gets the value at the specified position in the three-dimensional Array. Os índices são especificados como inteiro de 32 bits.The indexes are specified as 32-bit integers.

``````public:
System::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

Um inteiro de 32 bits que representa o índice da primeira dimensão do elemento Array a ser obtido.A 32-bit integer that represents the first-dimension index of the Array element to get.

index2
Int32

Um inteiro de 32 bits que representa o índice da segunda dimensão do elemento Array a ser obtido.A 32-bit integer that represents the second-dimension index of the Array element to get.

index3
Int32

Um inteiro de 32 bits que representa o índice da terceira dimensão do elemento Array a ser obtido.A 32-bit integer that represents the third-dimension index of the Array element to get.

#### Retornos

Object

O valor na posição especificada no Array tridimensional.The value at the specified position in the three-dimensional Array.

#### Exceções

O Array atual não tem exatamente três dimensões.The current Array does not have exactly three dimensions.

`index1` ou `index2` ou `index3` está fora do intervalo de índices válidos para a dimensão correspondente do Array atual.`index1` or `index2` or `index3` is outside the range of valid indexes for the corresponding dimension of the current Array.

### Comentários

Os métodos GetLowerBound e GetUpperBound podem determinar se alguns dos índices está fora dos limites.The GetLowerBound and GetUpperBound methods can determine whether any of the indexes is out of bounds.

Este método é uma operação O(1).This method is an O(1) operation.

## GetValue(Int64, Int64)

Obtém o valor na posição especificada no Array bidimensional.Gets the value at the specified position in the two-dimensional Array. Os índices são especificados como inteiros de 64 bits.The indexes are specified as 64-bit integers.

``````public:
System::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

Um inteiro de 64 bits que representa o índice da primeira dimensão do elemento Array a ser obtido.A 64-bit integer that represents the first-dimension index of the Array element to get.

index2
Int64

Um inteiro de 64 bits que representa o índice da segunda dimensão do elemento Array a ser obtido.A 64-bit integer that represents the second-dimension index of the Array element to get.

#### Retornos

Object

O valor na posição especificada no Array bidimensional.The value at the specified position in the two-dimensional Array.

Atributos

#### Exceções

O Array atual não tem exatamente duas dimensões.The current Array does not have exactly two dimensions.

`index1` ou `index2` está fora do intervalo de índices válidos para a dimensão correspondente do Arrayatual.Either `index1` or `index2` is outside the range of valid indexes for the corresponding dimension of the current Array.

### Comentários

Os métodos GetLowerBound e GetUpperBound podem determinar se alguns dos índices está fora dos limites.The GetLowerBound and GetUpperBound methods can determine whether any of the indexes is out of bounds.

Este método é uma operação O(1).This method is an O(1) operation.

## GetValue(Int32, Int32)

Obtém o valor na posição especificada no Array bidimensional.Gets the value at the specified position in the two-dimensional Array. Os índices são especificados como inteiro de 32 bits.The indexes are specified as 32-bit integers.

``````public:
System::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

Um inteiro de 32 bits que representa o índice da primeira dimensão do elemento Array a ser obtido.A 32-bit integer that represents the first-dimension index of the Array element to get.

index2
Int32

Um inteiro de 32 bits que representa o índice da segunda dimensão do elemento Array a ser obtido.A 32-bit integer that represents the second-dimension index of the Array element to get.

#### Retornos

Object

O valor na posição especificada no Array bidimensional.The value at the specified position in the two-dimensional Array.

#### Exceções

O Array atual não tem exatamente duas dimensões.The current Array does not have exactly two dimensions.

`index1` ou `index2` está fora do intervalo de índices válidos para a dimensão correspondente do Arrayatual.Either `index1` or `index2` is outside the range of valid indexes for the corresponding dimension of the current Array.

### Comentários

Os métodos GetLowerBound e GetUpperBound podem determinar se alguns dos índices está fora dos limites.The GetLowerBound and GetUpperBound methods can determine whether any of the indexes is out of bounds.

Este método é uma operação O(1).This method is an O(1) operation.

## GetValue(Int32)

Obtém o valor na posição especificada no Array unidimensional.Gets the value at the specified position in the one-dimensional Array. O índice é especificado como um inteiro de 32 bits.The index is specified as a 32-bit integer.

``````public:
System::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

Um inteiro de 32 bits que representa a posição do elemento Array a ser obtido.A 32-bit integer that represents the position of the Array element to get.

#### Retornos

Object

O valor na posição especificada no Array unidimensional.The value at the specified position in the one-dimensional Array.

#### Exceções

O Array atual não tem exatamente uma dimensão.The current Array does not have exactly one dimension.

`index` está fora do intervalo de índices válidos para o Array atual.`index` is outside the range of valid indexes for the current Array.

### Comentários

Os métodos GetLowerBound e GetUpperBound podem determinar se o valor `index` está fora dos limites.The GetLowerBound and GetUpperBound methods can determine whether the value of `index` is out of bounds.

Este método é uma operação O(1).This method is an O(1) operation.

## GetValue(Int64)

Obtém o valor na posição especificada no Array unidimensional.Gets the value at the specified position in the one-dimensional Array. O índice é especificado como um inteiro de 64 bits.The index is specified as a 64-bit integer.

``````public:
System::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

Um inteiro de 64 bits que representa a posição do elemento Array a ser obtido.A 64-bit integer that represents the position of the Array element to get.

#### Retornos

Object

O valor na posição especificada no Array unidimensional.The value at the specified position in the one-dimensional Array.

Atributos

#### Exceções

O Array atual não tem exatamente uma dimensão.The current Array does not have exactly one dimension.

`index` está fora do intervalo de índices válidos para o Array atual.`index` is outside the range of valid indexes for the current Array.

### Comentários

Os métodos GetLowerBound e GetUpperBound podem determinar se o valor `index` está fora dos limites.The GetLowerBound and GetUpperBound methods can determine whether the value of `index` is out of bounds.

Este método é uma operação O(1).This method is an O(1) operation.

## GetValue(Int32[])

Obtém o valor na posição especificada no Array multidimensional.Gets the value at the specified position in the multidimensional Array. Os índices são especificados como uma matriz de inteiros de 32 bits.The indexes are specified as an array of 32-bit integers.

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

Uma matriz unidimensional de inteiros de 32 bits que representa os índices especificando a posição do elemento Array a se obter.A one-dimensional array of 32-bit integers that represent the indexes specifying the position of the Array element to get.

#### Retornos

Object

O valor na posição especificada no Array multidimensional.The value at the specified position in the multidimensional Array.

#### Exceções

`indices` é `null`.`indices` is `null`.

O número de dimensões no Array atual não é igual ao número de elementos em `indices`.The number of dimensions in the current Array is not equal to the number of elements in `indices`.

Qualquer elemento em `indices` está fora do intervalo de índices válidos para a dimensão correspondente do Array atual.Any element in `indices` is outside the range of valid indexes for the corresponding dimension of the current Array.

### Comentários

O número de elementos em `indices` deve igual ao número de dimensões no Array.The number of elements in `indices` must equal the number of dimensions in the Array. Todos os elementos na matriz `indices` devem especificar coletivamente a posição do elemento desejado no Array multidimensional.All elements in the `indices` array must collectively specify the position of the desired element in the multidimensional Array.

Os métodos GetLowerBound e GetUpperBound podem determinar se alguns dos índices está fora dos limites.The GetLowerBound and GetUpperBound methods can determine whether any of the indexes is out of bounds.

Este método é uma operação O(1).This method is an O(1) operation.

## GetValue(Int64[])

Obtém o valor na posição especificada no Array multidimensional.Gets the value at the specified position in the multidimensional Array. Os índices são especificados como uma matriz de inteiros de 64 bits.The indexes are specified as an array of 64-bit integers.

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

Uma matriz unidimensional de inteiros de 64 bits que representa os índices especificando a posição do elemento Array a se obter.A one-dimensional array of 64-bit integers that represent the indexes specifying the position of the Array element to get.

#### Retornos

Object

O valor na posição especificada no Array multidimensional.The value at the specified position in the multidimensional Array.

Atributos

#### Exceções

`indices` é `null`.`indices` is `null`.

O número de dimensões no Array atual não é igual ao número de elementos em `indices`.The number of dimensions in the current Array is not equal to the number of elements in `indices`.

Qualquer elemento em `indices` está fora do intervalo de índices válidos para a dimensão correspondente do Array atual.Any element in `indices` is outside the range of valid indexes for the corresponding dimension of the current Array.

### Comentários

O número de elementos em `indices` deve igual ao número de dimensões no Array.The number of elements in `indices` must equal the number of dimensions in the Array. Todos os elementos na matriz `indices` devem especificar coletivamente a posição do elemento desejado no Array multidimensional.All elements in the `indices` array must collectively specify the position of the desired element in the multidimensional Array.

Os métodos GetLowerBound e GetUpperBound podem determinar se alguns dos índices está fora dos limites.The GetLowerBound and GetUpperBound methods can determine whether any of the indexes is out of bounds.

Este método é uma operação O(1).This method is an O(1) operation.