String.Length Propriedade

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

String.cs

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

public:
 property int Length { int get(); };

public int Length { get; }

member this.Length : int

Public ReadOnly Property Length As Integer

Valor da propriedade

Int32

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

Exemplos

O exemplo a seguir demonstra a Length propriedade .

// 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

let str = "abcdefg"
printfn $"1) The length of '{str}' is {str.Length}"
printfn $"""2) The length of '{"xyz"}' is {"xyz".Length}"""

let length = str.Length
printfn $"3) The length of '{str}' is {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
'
'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.

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

let characters = "abc\u0000def"
printfn $"{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

Confira também

• Int32