Conversion.Str(Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna 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 -> stringPublic Function Str (Number As Object) As StringParâmetros
- Number
- Object
Required. Uma Object expressão numérica válida que contém qualquer expressão numérica válida.
Retornos
Uma String representação de um número.
Exceções
Number não foi especificado.
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 subtração (-) 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 diferentes separadores decimais forem usados (por exemplo, em aplicativos internacionais), use o CStr ou Format as funções 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 do ToString(IFormatProvider) número. Por exemplo, use ToString ao converter um valor de tipo Double em uma cadeia de caracteres.