Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Dostęp do elementu: array[index]

Wyrażenie array[index] pozwala odczytać lub zmienić element tablicy. Nawiasy [] służą też do dostępu przez indeksatory; znaczenie argumentów zależy wtedy od danego typu.

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

Składnia

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

array[index] wskazuje element tablicy: array jest wyrażeniem zwracającym tablicę, a index określa pozycję. W zwykłej jednowymiarowej tablicy C# indeksy zaczynają się od 0 i kończą na array.Length - 1. Odczyt pobiera wartość elementu, a array[index] = value zapisuje nową wartość bez zmiany długości tablicy.

Indeks poza granicami tablicy powoduje IndexOutOfRangeException; dostęp przez referencję równą null powoduje NullReferenceException. Dla pustej tablicy żaden indeks elementu nie jest poprawny. array?[index] pomija dostęp, gdy tablica jest null, ale nie chroni przed błędnym indeksem dla istniejącej tablicy.

Tablica prostokątna używa jednego indeksu na wymiar, np. matrix[row, column]. Tablica tablic używa kolejnych operacji dostępu, np. rows[row][column]. Ten sam zapis [] obsługuje indeksatory obiektów, których argumentem może być np. klucz tekstowy. Ich reguły odczytu, zapisu i zgłaszania wyjątków zależą od typu; nie należy zakładać zachowania tablicy. Operatora [] nie przeciąża się bezpośrednio — własne typy udostępniają indeksatory.

Nawiasy w int[] deklarują typ tablicowy; nie odczytują elementu. Przykład pokazuje podstawowy odczyt i zapis elementu, bez funkcji wymagających wersji preview.

Przykłady

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]);
    }
}

Wynik

20
25
10

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła