Функция Str

Статья
11/05/2008

Обновлен: Ноябрь 2007

Представляет возвращаемое числовое значение как String.

Public Shared Function Str(ByVal Number As Object) As String

Параметры

Number
Обязательно. Object, содержащий какое-либо допустимое числовое выражение.

Исключения

Тип исключения	Номер ошибки	Условие
ArgumentNullException	5	Number не указан.
InvalidCastException	5	Number не относится к числовому типу.

См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err)). Однако по возможности следует изменить такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.

Заметки

При преобразовании чисел в строки начальный пробел всегда резервируется для знака Number. Если Number является положительным, возвращаемая строка содержит начальный пробел, где подразумевается знак плюс. Отрицательное число включает знак минус (-) и не имеет начального пробела.

Воспользуйтесь функцией Format, чтобы преобразовывать числовые значения в формат даты, времени, валюты или другие форматы, заданные пользователем. В отличие от функции Str, функция Format не включает начальный пробел для знака Number.

Примечание.
Функция Str распознает только точку (.) в качестве допустимого десятичного разделителя. Если применяются другие десятичные разделители (например, в многоязыковых приложениях), используйте функцию CStr или Format для преобразования числа в строку. Чтобы получить строковое представление числа для определенного языка и региона, используйте метод ToString(IFormatProvider) этого числа. Например, используйте ToString при преобразовании значения типа Double в строку.

Функция Str распознает только точку (.) в качестве допустимого десятичного разделителя. Если применяются другие десятичные разделители (например, в многоязыковых приложениях), используйте функцию CStr или Format для преобразования числа в строку. Чтобы получить строковое представление числа для определенного языка и региона, используйте метод ToString(IFormatProvider) этого числа. Например, используйте ToString при преобразовании значения типа Double в строку.

Пример

В данном примере функция Str используется для возврата представления String числа. При преобразовании положительного числа в строку начальный пробел всегда резервируется для знака.

Dim TestString As String
' Returns " 459".
TestString = Str(459)
' Returns "-459.65".
TestString = Str(-459.65)
' Returns " 459.001".
TestString = Str(459.001)