Left-Funktion (Visual Basic)
Aktualisiert: November 2007
Gibt eine Zeichenfolge zurück, die eine angegebene Anzahl von Zeichen ab dem am weitesten links stehenden Zeichen einer Zeichenfolge enthält.
Public Shared Function Left( _
ByVal str As String, _
ByVal Length As Integer _
) As String
Parameter
str
Erforderlich. String-Ausdruck, dessen am weitesten links stehende Zeichen zurückgegeben werden.Length
Erforderlich. Integer-Ausdruck. Numerischer Ausdruck, der die Anzahl der zurückzugebenden Zeichen angibt. Ist dieser Ausdruck null, wird eine leere Zeichenfolge ("") zurückgegeben. Ist der Wert größer oder gleich der Zeichenanzahl in str, wird die gesamte Zeichenfolge zurückgegeben.
Ausnahmen
Ausnahmetyp |
Fehlernummer |
Bedingung |
|---|---|---|
Length < 0. |
Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die die unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.
Hinweise
Verwenden Sie die Len-Funktion, wenn Sie die Anzahl der Zeichen in str ermitteln möchten. Wenn Sie die Funktion in einer Windows Forms-Anwendung oder in einer anderen Klasse verwenden, die über eine Left-Eigenschaft verfügt, müssen Sie die Funktion mit Microsoft.VisualBasic.Left vollständig qualifizieren.
.gif "Hinweis") Hinweis: |
|---|
Die LeftB-Funktion aus früheren Versionen von Visual Basic gibt eine Zeichenfolge in Bytes zurück, keine Zeichen. Sie wird vor allem zum Konvertieren von Zeichenfolgen in DBCS (Double-Byte Character Set)-Anwendungen verwendet. Alle aktuellen Visual Basic-Zeichenfolgen haben das Unicode-Format. LeftB wird nicht mehr unterstützt. |
Beispiel
In diesem Beispiel wird die Left-Funktion verwendet, um eine Teilzeichenfolge eines bestimmten String-Ausdrucks zurückzugeben. In einer Klasse, die über eine Left-Eigenschaft verfügt, muss die Left-Funktion vollständig qualifiziert werden.
Dim TestString As String = "Hello World!"
' Returns "Hello".
Dim subString As String = Microsoft.VisualBasic.Left(TestString, 5)
Anforderungen
Namespace:Microsoft.VisualBasic
**Modul:**Strings
**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Siehe auch
Konzepte
Änderungen an der Unterstützung von Programmierelementen (Zusammenfassung)