StrDup (Función)

Artículo
10/07/2008

Actualización: noviembre 2007

Devuelve una cadena o un objeto que se compone del carácter especificado repetido el número de veces especificado.

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

Parámetros

Number
Requerido. Expresión Integer. Longitud de la cadena que devolver.
Character
Requerido. Cualquier expresión Char, String u Object válida. Se utilizará sólo el primer carácter de la expresión. Si Character es de tipo Object, debe contener un valor Char o String .

Excepciones

Tipo de excepción	Número de error	Condición
ArgumentException		Number es menor que 0 o el tipo Character no es válido.
ArgumentNullException		Character es Nothing.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

Esta función devuelve una String compuesta de caracteres repetidos. El carácter que conforma la cadena es el primer carácter del argumento Character y se duplica tantas veces como indique Number.

Ejemplo

En este ejemplo se utiliza la función StrDup para devolver una cadena de caracteres duplicados.

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