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 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 -> stringPublic Function Str (Number As Object) As StringParâmetros
- Number
- Object
Obrigatórios. Um Object contendo qualquer expressão numérica válida.
Retornos
Uma representação String de um número.
Exceções
Number não está 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 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.
