Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Array.Length — número de elementos do array

Array.Length devolve o número de elementos de um array como int. Num array multidimensional, inclui todas as dimensões; num array vazio, o valor é 0.

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

Sintaxe

public int Length { get; }

array.Length

Array.Length é uma propriedade só de leitura: use array.Length, sem parênteses de chamada. A leitura tem complexidade O(1).

O comprimento corresponde ao número de posições para elementos, não ao número de valores diferentes de zero. Um array tem um tamanho fixo: new int[3] tem comprimento 3, embora inicialmente contenha apenas zeros.

Para new int[2, 3], Length é 6. Não o confunda com Rank, o número de dimensões. GetLength(0) e GetLength(1) devolvem os tamanhos de cada dimensão: 2 e 3.

Se um array multidimensional contiver mais de Int32.MaxValue elementos, a leitura de Length lança uma OverflowException. LongLength disponibiliza o número total de elementos como um inteiro de 64 bits.

Exemplos

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

Resultado

3
6
2
3
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes