CKTIS / C#
Array.Length — Anzahl der Arrayelemente
Array.Length gibt die Anzahl der Elemente eines Arrays als int zurück. Bei einem mehrdimensionalen Array umfasst der Wert alle Dimensionen; bei einem leeren Array ist er 0.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public int Length { get; }
array.LengthArray.Length ist eine schreibgeschützte Eigenschaft: Verwende array.Length ohne Aufrufklammern. Das Auslesen ist eine Operation mit der Komplexität O(1).
Die Länge bezeichnet die Anzahl der Elementplätze, nicht die Anzahl der Werte ungleich null. Ein Array hat eine feste Größe: new int[3] hat die Länge 3, obwohl es anfangs nur Nullen enthält.
Bei new int[2, 3] beträgt Length 6. Verwechsle den Wert nicht mit Rank, der Anzahl der Dimensionen. GetLength(0) und GetLength(1) geben die Größen der einzelnen Dimensionen zurück: 2 und 3.
Enthält ein mehrdimensionales Array mehr als Int32.MaxValue Elemente, löst das Auslesen von Length eine OverflowException aus. LongLength stellt die Gesamtzahl der Elemente als 64-Bit-Ganzzahl bereit.
Beispiele
using System;
int[] values = new int[3];
int[,] grid = new int[2, 3];
Console.WriteLine(values.Length);
Console.WriteLine(grid.Length);
Console.WriteLine(grid.GetLength(0));
Console.WriteLine(grid.GetLength(1));
Console.WriteLine(new int[0].Length);Ergebnis
3 6 2 3 0
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.