Conversion.Str(Object) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve uma String representação 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

Required. An contendo Object qualquer expressão numérica válida.

Devoluções

String

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

Exceções

ArgumentNullException

Number não é especificado.

InvalidCastException

Number não é um tipo numérico.

Exemplos

Este exemplo usa a Str função para devolver uma String representação de um número. Quando um número positivo é convertido numa cadeia, um espaço à esquerda é sempre reservado para o 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)

Observações

Quando os números são convertidos em cadeias, um espaço à frente é sempre reservado para o sinal de Number. Se Number for positivo, a cadeia devolvida contém um espaço à frente, e o sinal de mais é implícito. Um número negativo incluirá o sinal menos (-) e nenhum espaço à frente.

Use a Format função para converter valores numéricos que pretende formatar como datas, horas, moeda ou noutros formatos definidos pelo utilizador. Ao contrário da Str função, a Format função não inclui um espaço líder para o sinal de Number.

Note

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

Aplica-se a

Ver também