Compartilhar via


Função Str

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.

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)

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**Conversion

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Resumo de conversão

Função Format

Funções de conversão de tipo 

Função Format

Função Val

ArgumentNullException

InvalidCastException