StrDup, fonction

Article
09/12/2008

Mise à jour : novembre 2007

Retourne une chaîne ou un objet constitué du caractère spécifié répété le nombre de fois spécifié.

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

Paramètres

Number
Requis. Expression Integer. Longueur de la chaîne à retourner.
Character
Requis. Toute expression Char, String ou Object valide. Seul le premier caractère de l'expression sera utilisé. Si le caractère est de type Object, il doit contenir une valeur Char ou String

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	Number est inférieur à 0 ou le type Character n'est pas valide.
ArgumentNullException	5	Character a la valeur Nothing.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Cette fonction retourne une expression String constituée de caractères répétés. Le caractère qui constitue la chaîne est le premier caractère de l'argument Character et il est dupliqué Number de fois.

Exemple

L'exemple suivant utilise la fonction StrDup pour retourner une chaîne de caractères dupliqués.

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))