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

Статья
11/05/2008

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

Возвращает выражение в формате процента (т. е. с коэффициентом 100), в конец которого добавлен знак %.

Function FormatPercent(
   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.Default	Региональные параметры, установленные на компьютере

Исключения

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

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

Заметки

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

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

Пример

Следующий пример показывает использование функции FormatPercent.

Dim TestNumber As Single = 0.76
' Returns "76.00%".
Dim TestString As String = FormatPercent(TestNumber)

Требования

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

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

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

См. также

Ссылки

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

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

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

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

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

InvalidCastException

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