Função StrDup

Artigo
08/25/2010

Retorna uma seqüência de caracteres ou objeto que consiste o caractere especificado repetida o número de vezes 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
Obrigatório.Integer expressão. O comprimento para a seqüência de caracteres a ser retornado.
Character
Obrigatório.Qualquer válido Char, String, ou Object expressão. Somente o primeiro caractere da expressão será usado.Se o caractere é de digite Object, ele deve conter um um Char ou um String valor.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Number é menor que 0 ou Character tipo inválido.
ArgumentNullException	5	Character é Nothing.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Esta função retorna um String composto por caracteres repetidos. O caractere que constitui a seqüência é o primeiro caractere no Character argumento e ele é duplicado Number número de vezes.

Exemplo

Este exemplo usa o StrDup função para retornar uma seqüência de caracteres duplicadas.

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