WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Elementzugriff: array[index]

Der Ausdruck array[index] liest oder ändert ein Arrayelement. Eckige Klammern [] ermöglichen auch den Zugriff auf Indexer; die Bedeutung ihrer Argumente hängt dann vom jeweiligen Typ ab.

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

Syntax

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

array[index] bezeichnet ein Arrayelement: array ist ein Ausdruck, der ein Array zurückgibt, und index gibt die Position an. Bei einem gewöhnlichen eindimensionalen C#-Array beginnen die Indizes bei 0 und enden bei array.Length - 1. Beim Lesen wird der Wert des Elements abgerufen; array[index] = value speichert einen neuen Wert, ohne die Länge des Arrays zu ändern.

Ein Index außerhalb der Arraygrenzen verursacht IndexOutOfRangeException; der Zugriff über eine Referenz, die null ist, verursacht NullReferenceException. Bei einem leeren Array ist kein Elementindex gültig. array?[index] überspringt den Zugriff, wenn das Array null ist, schützt aber bei einem vorhandenen Array nicht vor einem ungültigen Index.

Ein rechteckiges Array verwendet einen Index pro Dimension, zum Beispiel matrix[row, column]. Ein gezacktes Array verwendet aufeinanderfolgende Zugriffsschritte, zum Beispiel rows[row][column]. Dieselbe Schreibweise [] unterstützt Objekt-Indexer, deren Argument beispielsweise ein Zeichenfolgen-Schlüssel sein kann. Deren Regeln zum Lesen, Schreiben und für Ausnahmen hängen vom Typ ab; das Verhalten eines Arrays darf nicht vorausgesetzt werden. [] lässt sich nicht direkt überladen — eigene Typen stellen stattdessen Indexer bereit.

Die Klammern in int[] deklarieren einen Arraytyp; sie lesen kein Element. Das Beispiel veranschaulicht das grundlegende Lesen und Schreiben von Elementen, ohne Funktionen zu verwenden, die eine Preview-Sprachversion erfordern.

Beispiele

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

Ergebnis

20
25
10

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen