Right-Funktion (Visual Basic)

Aktualisiert: November 2007

Gibt eine Zeichenfolge mit einer bestimmten Anzahl von Zeichen ab dem ersten Zeichen rechts von einer Zeichenfolge zurück.

Public Shared Function Right( _
   ByVal str As String, _
   ByVal Length As Integer _
) As String

Parameter

• str
  Erforderlich. String-Ausdruck, dessen am weitesten rechts stehende Zeichen zurückgegeben werden.

• Length
  Erforderlich. Integer. Numerischer Ausdruck, der die Anzahl der zurückzugebenden Zeichen angibt. Bei 0 wird eine leere Zeichenfolge ("") zurückgegeben. Ist der Wert größer als oder gleich der Zeichenanzahl in str, wird die gesamte Zeichenfolge zurückgegeben.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Length < 0.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine 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 Form oder in einer anderen Klasse verwenden, die über eine Right-Eigenschaft verfügt, müssen Sie die Funktion mit Microsoft.VisualBasic.Right vollständig qualifizieren.

Hinweis:
Die RightB-Funktion aus früheren Versionen von Visual Basic gibt eine Zeichenfolge in Bytes 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. RightB wird nicht mehr unterstützt.

Beispiel

In diesem Beispiel wird die Right-Funktion verwendet, um eine Teilzeichenfolge eines bestimmten String-Ausdrucks zurückzugeben. In einer Klasse, die über eine Right-Eigenschaft verfügt, muss die Right-Funktion unter Umständen vollständig qualifiziert werden.

Dim TestString As String = "Hello World!"
' Returns "World!".
Dim subString As String = Microsoft.VisualBasic.Right(TestString, 6)

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)

Referenz

Zeichenfolgenbearbeitung: Zusammenfassung

Left-Funktion (Visual Basic)

Len-Funktion (Visual Basic)

Mid-Funktion (Visual Basic)

ArgumentException