Len-Funktion (Visual Basic)

Artikel
09/03/2008

Aktualisiert: November 2007

Gibt einen Ganzzahlwert zurück, der entweder die Anzahl der Zeichen in einer Zeichenfolge oder die zum Speichern einer Variablen erforderliche nominale Byteanzahl enthält.

Public Shared Function Len( _
   ByVal Expression As { Boolean | Byte | SByte | Char | Double |
   Integer | UInteger | Long | ULong | Object | Short | UShort |
   Single | String | DateTime | Decimal } _
) As Integer

Parameter

Expression
Ein beliebiger gültiger String-Ausdruck oder Variablenname. Wenn Expression vom Typ Object ist, gibt die Len-Funktion die Größe zurück, die zum Schreiben in die Datei mithilfe der FilePut-Funktion benötigt wird.

Hinweise

Bei benutzerdefinierten Typen und Object-Variablen gibt die Len-Funktion die Größe zurück, die zum Schreiben in die Datei mithilfe der FilePut-Funktion benötigt wird. Wenn ein Object einen String-Ausdruck enthält, wird die Länge der Zeichenfolge zurückgegeben. Wenn ein Object einen beliebigen anderen Typ enthält, wird die Größe des Objekts zurückgegeben, die zum Schreiben in die Datei mithilfe der FilePut-Funktion benötigt wird.

Zeichenfolgenfelder in Objekten können mit dem VBFixedString-Attribut versehen werden, das die Größe der Zeichenfolge (in Bytes) beim Schreiben auf den Datenträger angibt. Die Len-Funktion verwendet das VBFixedString-Attribut (falls verfügbar) beim Bestimmen der Größe von Object-Variablen.

Hinweis:
Wenn die Len-Funktion mit Zeichenfolgen beliebiger Länge in benutzerdefinierten Datentypen verwendet wird, kann sie unter Umständen die Anzahl der zum Speichern erforderlichen Bytes nicht ermitteln.

Hinweis:
Die LenB-Funktion aus früheren Versionen von Visual Basic gibt eine Reihe von Bytes in einer Zeichenfolge zurück und keine Zeichen. Sie wird primär zum Konvertieren von Zeichenfolgen in DBCS (Double-Byte Character Set)-Anwendungen verwendet. Alle aktuellen Visual Basic-Zeichenfolgen haben das Unicode-Format. LenB wird nicht mehr unterstützt.

Beispiel

In diesem Beispiel wird mit der Len-Funktion die Anzahl der Zeichen in einer Zeichenfolge zurückgegeben.

' Initializes variable.
Dim TestString As String = "Hello World"
' Returns 11.
Dim TestLen As Integer = Len(TestString)

Hinweise für Entwickler intelligenter Geräte

Die Len-Funktion akzeptiert nur String- und Object-Variablen als Parameter. Wenn ein Object einen String enthält, wird die Länge von String zurückgegeben. Wenn ein Parameter ein NULL-Object-Verweis ist, gibt die Funktion null zurück. Enthält ein Object einen beliebigen anderen Typ, wird eine Ausnahme ausgelöst.