Conversion.Str(Object) Método

  • Referência

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Origem:
Conversion.vb
Origem:
Conversion.vb
Origem:
Conversion.vb

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

public:
 static System::String ^ Str(System::Object ^ Number);
public static string Str (object Number);
static member Str : obj -> string
Public Function Str (Number As Object) As String

Parâmetros

Number
Object

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

Retornos

String

Uma representação String de um número.

Exceções

ArgumentNullException

Number não está especificado.

InvalidCastException

Number não é um tipo numérico.

Exemplos

Este exemplo usa a Str função para retornar uma String representação de um número. Quando um número positivo é convertido em uma cadeia 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)

Comentários

Quando os números são convertidos em cadeias de caracteres, um espaço à esquerda é sempre reservado para o sinal de Number. Se Number for positivo, a cadeia de caracteres retornada conterá um espaço à esquerda e o sinal de adição estará implícito. Um número negativo incluirá o sinal de menos (-) e nenhum espaço à esquerda.

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

Observação

A Str função reconhece apenas o período (.) como um separador decimal válido. Se separadores decimais diferentes forem usados (por exemplo, em aplicativos internacionais), use as CStr funções ou Format para converter um número em uma cadeia de caracteres. Para obter a representação de cadeia de caracteres de um número em uma cultura específica, use o método ToString(IFormatProvider) do número. Por exemplo, use ToString ao converter um valor do tipo Double em uma cadeia de caracteres.

Aplica-se a

Confira também