String.Length Propriedade

Definição

Obtém o número de caracteres no objeto String atual.

C#
public int Length { get; }

Valor da propriedade

O número de caracteres na cadeia de caracteres atual.

Exemplos

O exemplo a seguir demonstra a Length propriedade .

C#
string str = "abcdefg";
Console.WriteLine("1) The length of '{0}' is {1}", str, str.Length);
Console.WriteLine("2) The length of '{0}' is {1}", "xyz", "xyz".Length);

int length = str.Length;
Console.WriteLine("3) The length of '{0}' is {1}", str, length);

// This example displays the following output:
//    1) The length of 'abcdefg' is 7
//    2) The length of 'xyz' is 3
//    3) The length of 'abcdefg' is 7

Comentários

A Length propriedade retorna o número de Char objetos nesta instância, não o número de caracteres Unicode. O motivo é que um caractere Unicode pode ser representado por mais de um Char. Use a System.Globalization.StringInfo classe para trabalhar com cada caractere Unicode em vez de cada Char.

Em algumas linguagens, como C e C++, um caractere nulo indica o fim de uma cadeia de caracteres. No .NET, um caractere nulo pode ser inserido em uma cadeia de caracteres. Quando uma cadeia de caracteres inclui um ou mais caracteres nulos, elas são incluídas no comprimento da cadeia de caracteres total. Por exemplo, na cadeia de caracteres a seguir, as subcadeias de caracteres "abc" e "def" são separadas por um caractere nulo. A Length propriedade retorna 7, o que indica que ela inclui os seis caracteres alfabéticos, bem como o caractere nulo.

C#
string characters = "abc\u0000def";
Console.WriteLine(characters.Length); // Displays 7

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Confira também