WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

System.Index und System.Range — Indizes und Bereiche

System.Index beschreibt eine Position, die vom Anfang oder Ende einer Sequenz aus gezählt wird; System.Range beschreibt einen Bereich mit eingeschlossenem Anfang und ausgeschlossenem Ende. Die Operatoren ^ und .. erleichtern den Zugriff auf Elemente und Ausschnitte. Aufwand und gemeinsame Datennutzung hängen vom Sequenztyp ab.

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

Syntax

Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];

System.Index und System.Range sind unveränderliche Werttypen, die seit C# 8 Indizierung und Bereichsauswahl unterstützen. Sie sind in .NET 10 verfügbar; die Repository-Einstellung LangVersion=preview ist für diese Funktion nicht erforderlich. Sie speichern Beschreibungen von Positionen oder Bereichen, nicht die Sequenz selbst oder ihre Elemente.

Index speichert Value und IsFromEnd. Ein gewöhnlicher nicht negativer int wird implizit in einen vom Anfang gezählten Index umgewandelt. ^n bedeutet Position Length - n: ^1 bezeichnet das letzte Element einer nicht leeren Sequenz, während ^0 die Grenze direkt hinter dem Ende ist. Daher löst values[^0] eine Ausnahme aus. Ein negativer Wert, der an den Index-Konstruktor übergeben oder aus int konvertiert wird, führt zu ArgumentOutOfRangeException. GetOffset(length) berechnet einen Offset, prüft aber nicht, ob dieser ein vorhandenes Element bezeichnet.

Range enthält die Indizes Start und End. Der Ausdruck a..b schließt den Anfang ein, das Ende jedoch aus; 1..^1 lässt das erste und letzte Element aus. Nicht angegebene Grenzen haben standardmäßig die Werte 0 und ^0: ..b, a.. und ... GetOffsetAndLength(length) gibt einen Offset und die Elementanzahl zurück. Die Methode löst ArgumentOutOfRangeException aus, wenn die Grenzen außerhalb von 0..length liegen oder der Anfang hinter dem Ende liegt. Gleiche Grenzen beschreiben einen leeren Ausschnitt, keinen umgekehrten Bereich.

Eindimensionale Arrays, string, Span<T> und ReadOnlySpan<T> unterstützen diese Syntax. Die bloße Implementierung von IEnumerable<T> reicht nicht aus: Erforderlich sind geeignete Indexer oder ein vom Compiler erkanntes Muster. Ein Array-Ausschnitt erstellt eine flache Kopie der Elemente; Objekte, auf die Elemente eines Referenztyps verweisen, können weiterhin gemeinsam genutzt werden. Ein Ausschnitt von Span<T> oder ReadOnlySpan<T> ist eine Sicht auf denselben Speicher, ohne die Elemente zu kopieren.

Beispiele

using System;

internal static class Program
{
    private static void Main()
    {
        int[] values = { 10, 20, 30, 40, 50 };
        Index last = ^1;
        Range middle = 1..^1;
        int[] copy = values[middle];
        copy[0] = 99;

        Console.WriteLine(values[last]);
        Console.WriteLine(string.Join(",", copy));
        Console.WriteLine(values[1]);
        var (offset, length) = middle.GetOffsetAndLength(values.Length);
        Console.WriteLine($"{offset}:{length}");
    }
}

Ergebnis

50
99,30,40
20
1:3

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