Функция FormatNumber (Visual Basic)

Статья
11/05/2008

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

Возвращает выражение в формате числа.

Function FormatNumber(
   ByVal Expression As Object,
   Optional ByVal NumDigitsAfterDecimal As Integer = -1,
   Optional ByVal IncludeLeadingDigit As TriState = TriState.UseDefault,
   Optional ByVal UseParensForNegativeNumbers As TriState = TriState.UseDefault,
   Optional ByVal GroupDigits As TriState = TriState.UseDefault
) As String

Параметры

Expression
Обязательно. Выражение, подлежащее форматированию.
NumDigitsAfterDecimal
Необязательно. Числовое значение, указывающее количество цифр, которые должны быть отображены справа от десятичного разделителя. По умолчанию принимается значение –1, что указывает на использование региональных параметров компьютера.
IncludeLeadingDigit
Необязательно. Константа TriState, указывающая, следует ли отображать старший ноль в числах с дробной частью. См. "Параметры" для значений.
UseParensForNegativeNumbers
Необязательно. Константа TriState, указывающая, следует ли ставить отрицательные числа в скобки. См. "Параметры" для значений.
GroupDigits
Необязательно. Константа TriState, которая указывает, следует ли объединять разряды чисел в группы, используя разделитель групп, определенный в параметрах языкового стандарта. См. "Параметры" для значений.

Settings

Аргументы IncludeLeadingDigit, UseParensForNegativeNumbers и GroupDigits имеют следующие значения.

Константа	Описание
TriState.True	True
TriState.False	False
TriState.UseDefault	Региональные параметры, установленные на компьютере

Исключения

Тип исключения	Номер ошибки	Условие
InvalidCastException	13	Тип не является числовым.

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

Заметки

Если один или несколько опциональных аргументов опущены, то вместо них используются значения локальных установок.

Примечание.
Все сведения о настройках определяются языковым стандартом приложения. По умолчанию используется локальная установка в панели управления. Однако он может быть изменен программным способом с помощью .NET Framework.

Пример

В этом примере показано, как используется функция FormatNumber.

Dim TestNumber As Integer = 45600
' Returns "45,600.00".
Dim TestString As String = FormatNumber(TestNumber, 2, , , TriState.True)

Требования

Пространство имен:Microsoft.VisualBasic

**Модуль:**Strings

**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

См. также

Ссылки

Сводка по работе со строками

Функция FormatCurrency (Visual Basic)

Функция FormatDateTime (Visual Basic)

Функция FormatPercent (Visual Basic)

Перечисление TriState

InvalidCastException

Поделиться через