Função Str

Artigo
08/25/2010

Retorna um representação em String de um número.

Public Shared Function Str(ByVal Number As Object) As String

Parâmetros

Number
Obrigatório.Um Object contendo qualquer expressão numérica válida.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentNullException	5	Number não foi especificado.
InvalidCastException	5	Number é um tipo não numérico.

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

Quando os números são convertidos para sequências de caracteres, um espaço à esquerda é sempre reservado para o sinal de Number.Se Number for positivo, a sequência de caracteres retornada contém um espaço à esquerda, e o sinal de mais é inferido.Um número negativo incluirá o sinal de subtração (-) e não há espaço à esquerda.

Use a função Format para converter valores numéricos que você deseja formatados como datas, horas ou moeda ou em outros formatos definidos pelo usuário.Diferente da função Str, a função Format não inclui um espaço para o sinal de Number à esquerda.

Observação:
O Str função reconhece somente o período (.) sistema autônomo separador decimal válido. Se separadores decimais diferentes forem usados (por exemplo, em aplicativos internacionais), usar as funções CStr ou Format para converter um número em uma sequência de caracteres.Para obter a representação string de um número numa cultura particular, use método ToString(IFormatProvider) do número.Por exemplo, use ToString quando converter um valor do tipo Double para uma cadeia de caracteres.

O Str função reconhece somente o período (.) sistema autônomo separador decimal válido. Se separadores decimais diferentes forem usados (por exemplo, em aplicativos internacionais), usar as funções CStr ou Format para converter um número em uma sequência de caracteres.Para obter a representação string de um número numa cultura particular, use método ToString(IFormatProvider) do número.Por exemplo, use ToString quando converter um valor do tipo Double para uma cadeia de caracteres.

Exemplo

Este exemplo usa a função Str para retornar uma representação String de um número.Quando um número positivo é convertido em uma sequência de caracteres, um espaço à esquerda é sempre reservado para seu sinal.

Dim TestString As String
' Returns " 459".
TestString = Str(459)
' Returns "-459.65".
TestString = Str(-459.65)
' Returns " 459.001".
TestString = Str(459.001)