String.Length String.Length String.Length String.Length Property

Définition

Obtient le nombre de caractères de l'objet String actuel.Gets the number of characters in the current String object.

public:
 property int Length { int get(); };
public int Length { get; }
member this.Length : int
Public ReadOnly Property Length As Integer

Valeur de propriété

Nombre de caractères de la chaîne actuelle.The number of characters in the current string.

Exemples

L’exemple suivant illustre la Length propriété.The following example demonstrates the Length property.

// Sample for String::Length
using namespace System;
int main()
{
   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", ((String^)"xyz")->Length );
   int length = str->Length;
   Console::WriteLine( "1) 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
*/
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
Class Sample
   Public Shared Sub Main()
      Dim str As String = "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)
      Dim length As Integer = str.Length
      Console.WriteLine("1) The length of '{0}' is {1}", str, length)
   End Sub
End Class 'Sample
'
'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.The Length property returns the number of Char objects in this instance, not the number of Unicode characters. La raison en est qu’un caractère Unicode peut être représenté par plusieurs Char.The reason is that a Unicode character might be represented by more than one Char. Utilisez la System.Globalization.StringInfo classe pour travailler avec chaque caractère Unicode au lieu de Charchaque.Use the System.Globalization.StringInfo class to work with each Unicode character instead of each Char.

Dans certains langages, tels que C C++et, un caractère null indique la fin d’une chaîne.In some languages, such as C and C++, a null character indicates the end of a string. Dans .NET, un caractère NULL peut être incorporé dans une chaîne.In .NET, a null character can be embedded in a string. Lorsqu’une chaîne comprend un ou plusieurs caractères null, ceux-ci sont inclus dans la longueur de la chaîne totale.When a string includes one or more null characters, they are included in the length of the total string. Par exemple, dans la chaîne suivante, les sous-chaînes « ABC » et « def » sont séparées par un caractère null.For example, in the following string, the substrings "abc" and "def" are separated by a null character. La Length propriété retourne 7, ce qui indique qu’elle comprend les six caractères alphabétiques, ainsi que le caractère null.The Length property returns 7, which indicates that it includes the six alphabetic characters as well as the null character.

using namespace System;
using namespace System::Text;

void main()
{
   String^ characters = "abc" + L'0' + "def";
   Console::WriteLine(characters->Length);        // Displays 7
}
string characters = "abc\u0000def";
Console.WriteLine(characters.Length); // Displays 7
Imports System.Text

Module Example

   Public Sub Main()
      Dim characters As String = "abc" + ChrW(0) + "def"
      Console.WriteLine(characters.Length)       ' Displays 7
   End Sub
End Module

S’applique à

Voir aussi