Lire en anglais

Partager via


String.Length Propriété

Définition

Obtient le nombre de caractères de l'objet String actuel.

C#
public int Length { get; }

Valeur de propriété

Int32

Nombre de caractères de la chaîne actuelle.

Exemples

L’exemple suivant illustre la Length propriété.

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

Remarques

La Length propriété retourne le nombre d' Char objets dans cette instance, et non le nombre de caractères Unicode. La raison en est qu’un caractère Unicode peut être représenté par plusieurs Char . Utilisez la System.Globalization.StringInfo classe pour travailler avec chaque caractère Unicode au lieu de chaque Char .

Dans certains langages, tels que C et C++, un caractère null indique la fin d’une chaîne. Dans .NET, un caractère NULL peut être incorporé dans une chaîne. Lorsqu’une chaîne comprend un ou plusieurs caractères null, ceux-ci sont inclus dans la longueur de la chaîne totale. Par exemple, dans la chaîne suivante, les sous-chaînes « ABC » et « def » sont séparées par un caractère null. La Length propriété retourne 7, ce qui indique qu’elle comprend les six caractères alphabétiques, ainsi que le caractère null.

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

S’applique à

Produit Versions
.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
.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
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Voir aussi