# String.Length Eigenschaft

## Definition

Ruft die Anzahl der Zeichen im aktuellen String-Objekt ab.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``

#### Eigenschaftswert

Die Anzahl der Zeichen in der aktuellen Zeichenfolge.The number of characters in the current string.

## Beispiele

Im folgenden Beispiel wird die Length-Eigenschaft veranschaulicht.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
'
'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
``````

## Hinweise

Die Length-Eigenschaft gibt die Anzahl der Char Objekte in dieser Instanz zurück, nicht die Anzahl der Unicode-Zeichen.The Length property returns the number of Char objects in this instance, not the number of Unicode characters. Der Grund hierfür ist, dass ein Unicode-Zeichen durch mehr als eine Chardargestellt werden kann.The reason is that a Unicode character might be represented by more than one Char. Verwenden Sie die System.Globalization.StringInfo-Klasse, um mit jedem Unicode-Zeichen anstelle der einzelnen Charzu arbeiten.Use the System.Globalization.StringInfo class to work with each Unicode character instead of each Char.

In einigen Sprachen, wie z. b C++. C und, gibt ein NULL-Zeichen das Ende einer Zeichenfolge an.In some languages, such as C and C++, a null character indicates the end of a string. In .net kann ein NULL-Zeichen in eine Zeichenfolge eingebettet werden.In .NET, a null character can be embedded in a string. Wenn eine Zeichenfolge ein oder mehrere NULL Zeichen enthält, sind Sie in der Länge der gesamten Zeichenfolge enthalten.When a string includes one or more null characters, they are included in the length of the total string. In der folgenden Zeichenfolge werden z. b. die Teil Zeichenfolgen "ABC" und "Def" durch ein NULL-Zeichen voneinander getrennt.For example, in the following string, the substrings "abc" and "def" are separated by a null character. Die Length-Eigenschaft gibt 7 zurück, was darauf hinweist, dass Sie die sechs alphabetischen Zeichen sowie das NULL-Zeichen enthält.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
``````