StrDup-Funktion

Artikel
09/03/2008

Aktualisiert: November 2007

Gibt eine Zeichenfolge oder ein Objekt zurück, in der bzw. dem das angegebene Zeichen so häufig wie angegeben wiederholt wird.

Public Shared Function StrDup( _
   ByVal Number As Integer, _
   ByVal Character As { Char | String } _
) As String
' -or-
Public Shared Function StrDup( _
   ByVal Number As Integer, _
   ByVal Character As Object _
) As Object

Parameter

Number
Erforderlich. Integer-Ausdruck. Die Länge der zurückzugebenden Zeichenfolge.
Character
Erforderlich. Ein beliebiger gültiger Char-Ausdruck, String-Ausdruck oder Object-Ausdruck. Es wird nur das erste Zeichen des Ausdrucks verwendet. Wenn Character vom Typ Object ist, muss es entweder einen Char-Wert oder einen String -Wert enthalten.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Number ist kleiner als 0 (null), oder der Character-Typ ist nicht gültig.
ArgumentNullException	5	Character hat den Wert Nothing.

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

Diese Funktion gibt einen String-Ausdruck mit sich wiederholenden Zeichen zurück. Das Zeichen, das die Zeichenfolge bildet, entspricht dem ersten Zeichen des Character-Arguments und wird so oft wiederholt, wie mit Number festgelegt.

Beispiel

In diesem Beispiel wird die StrDup-Funktion verwendet, um eine Zeichenfolge mit duplizierten Zeichen zurückzugeben:

Dim aString As String = "Wow! What a string!"
Dim aObject As New Object
Dim TestString As String
aObject = "This is a String contained within an Object"
' Returns "PPPPP"
TestString = StrDup(5, "P")
' Returns "WWWWWWWWWW"
TestString = StrDup(10, aString)
' Returns "TTTTTT"
TestString = CStr(StrDup(6, aObject))