Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Array.Length — liczba elementów tablicy

Array.Length zwraca liczbę elementów tablicy jako int. Dla tablicy wielowymiarowej obejmuje wszystkie wymiary, a dla pustej tablicy wynosi 0.

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

Składnia

public int Length { get; }

array.Length

Array.Length to właściwość tylko do odczytu: używaj array.Length, bez nawiasów wywołania. Odczyt ma złożoność O(1).

Długość oznacza liczbę miejsc na elementy, nie liczbę wartości różnych od zera. Tablica ma stały rozmiar: new int[3] ma długość 3, mimo że początkowo zawiera same zera.

Dla new int[2, 3] właściwość Length wynosi 6. Nie myl jej z Rank, czyli liczbą wymiarów. GetLength(0) i GetLength(1) zwracają rozmiary poszczególnych wymiarów: 2 i 3.

Jeśli tablica wielowymiarowa zawiera więcej niż Int32.MaxValue elementów, odczyt Length zgłasza OverflowException. LongLength udostępnia łączną liczbę elementów jako 64-bitową liczbę całkowitą.

Przykłady

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

Wynik

3
6
2
3
0

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

Źródła