Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Acesso a elementos: array[index]

A expressão array[index] lê ou altera um elemento de um array. Os parênteses retos [] também permitem aceder a indexadores; nesse caso, o significado dos argumentos depende do tipo específico.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

array[index]
array[index] = value;
matrix[row, column]
objectWithIndexer[key]

array[index] identifica um elemento de um array: array é uma expressão que devolve um array e index especifica a posição. Num array C# unidimensional comum, os índices começam em 0 e terminam em array.Length - 1. A leitura obtém o valor do elemento, enquanto array[index] = value guarda um novo valor sem alterar o comprimento do array.

Um índice fora dos limites do array provoca IndexOutOfRangeException; o acesso através de uma referência igual a null provoca NullReferenceException. Um array vazio não tem índices de elemento válidos. array?[index] ignora o acesso quando o array é null, mas não protege contra um índice inválido se o array existir.

Um array retangular usa um índice por dimensão, como matrix[row, column]. Um array irregular usa operações de acesso sucessivas, como rows[row][column]. A mesma notação [] permite aceder a indexadores de objetos, cujo argumento pode ser, por exemplo, uma chave de texto. As regras de leitura, escrita e exceções dependem do tipo; não se deve presumir que se comportam como arrays. Não é possível sobrecarregar [] diretamente — os tipos personalizados fornecem indexadores em alternativa.

Os parênteses em int[] declaram um tipo de array; não leem um elemento. O exemplo demonstra a leitura e a escrita básicas de elementos, sem funcionalidades que exijam uma versão preview da linguagem.

Exemplos

using System;

class Program
{
    static void Main()
    {
        int[] array = { 10, 20, 30 };
        int index = 1;
        Console.WriteLine(array[index]);
        array[index] = 25;
        Console.WriteLine(array[index]);
        Console.WriteLine(array[0]);
    }
}

Resultado

20
25
10

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes