String.Length 屬性

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

String.cs

取得目前 String 物件中的字元數。

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

public int Length { get; }

member this.Length : int

Public ReadOnly Property Length As Integer

屬性值

Int32

目前字串的字元數。

範例

以下範例展示了該 Length 性質。

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

備註

該 Length 屬性回傳的是此實例中的物件數量 Char ，而非 Unicode 字元數。 原因是一個 Unicode 字元可能由多個 Char表示。 使用 System.Globalization.StringInfo 類別來處理每個 Unicode 字元，而非每個字 Char元。

在某些語言中，如 C 和 C++，空字元表示字串的結尾。 在 .NET 中，可以在字串中嵌入空字元。 當字串包含一個或多個空字元時，這些字元會包含在整個字串的長度中。 例如，在以下字串中，子字串「abc」和「def」之間有一個空字元分隔。 該 Length 屬性回傳 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

另請參閱

• Int32