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.