Conversion.Str(Object) Método

Definição

Retorna uma representação String de um número.Returns a String representation of a number.

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ório.Required. Um Object contendo qualquer expressão numérica válida.An Object containing any valid numeric expression.

Retornos

Uma representação String de um número.A String representation of a number.

Exceções

Number não está especificado.Number is not specified.

Number não é um tipo numérico.Number is not a numeric type.

Exemplos

Este exemplo usa a função Str para retornar uma representação de String de um número.This example uses the Str function to return a String representation of a number. Quando um número positivo é convertido em uma cadeia de caracteres, um espaço à esquerda é sempre reservado para seu sinal.When a positive number is converted to a string, a leading space is always reserved for its sign.

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.When numbers are converted to strings, a leading space is always reserved for the sign of Number. Se Number for positivo, a cadeia de caracteres retornada conterá um espaço à esquerda e o sinal de adição será implícito.If Number is positive, the returned string contains a leading space, and the plus sign is implied. Um número negativo incluirá o sinal de subtração (-) e nenhum espaço à esquerda.A negative number will include the minus sign (-) and no leading space.

Use a função Format para converter valores numéricos que você deseja formatar como datas, horas ou moeda ou em outros formatos definidos pelo usuário.Use the Format function to convert numeric values you want formatted as dates, times, or currency or in other user-defined formats. Ao contrário da função Str, a função Format não inclui um espaço à esquerda para o sinal de Number.Unlike the Str function, the Format function does not include a leading space for the sign of Number.

Observação

A função Str reconhece apenas o período (.) como um separador decimal válido.The Str function recognizes only the period (.) as a valid decimal separator. Se separadores decimais diferentes forem usados (por exemplo, em aplicativos internacionais), use as funções CStr ou Format para converter um número em uma cadeia de caracteres.If different decimal separators are used (for example, in international applications), use the CStr or Format functions to convert a number to a string. 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.To get the string representation of a number in a particular culture, use the number's ToString(IFormatProvider) method. Por exemplo, use ToString ao converter um valor do tipo Double em uma cadeia de caracteres.For example, use ToString when converting a value of type Double to a string.

Aplica-se a

Veja também