Strings.FormatPercent(Object, Int32, TriState, TriState, TriState) Метод

Определение

Возвращает выражение в виде процента (умноженное на 100) с символом % в конце.Returns an expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.

public static string FormatPercent (object Expression, int NumDigitsAfterDecimal = -1, Microsoft.VisualBasic.TriState IncludeLeadingDigit = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState UseParensForNegativeNumbers = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState GroupDigits = Microsoft.VisualBasic.TriState.UseDefault);
static member FormatPercent : obj * int * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState -> string
Public Function FormatPercent (Expression As Object, Optional NumDigitsAfterDecimal As Integer = -1, Optional IncludeLeadingDigit As TriState = Microsoft.VisualBasic.TriState.UseDefault, Optional UseParensForNegativeNumbers As TriState = Microsoft.VisualBasic.TriState.UseDefault, Optional GroupDigits As TriState = Microsoft.VisualBasic.TriState.UseDefault) As String

Параметры

Expression
Object

Обязательный.Required. Форматируемое выражение.Expression to be formatted.

NumDigitsAfterDecimal
Int32

Необязательный элемент.Optional. Числовое значение, указывающее количество отображаемых цифр справа от десятичной запятой.Numeric value indicating how many places to the right of the decimal are displayed. По умолчанию используется значение –1, указывающее на использование настроек языкового стандарта.Default value is -1, which indicates that the locale settings are used.

IncludeLeadingDigit
TriState

Необязательный элемент.Optional. Константа TriState, указывающая, отображается ли ноль в дробных значениях.TriState constant that indicates whether or not a leading zero displays for fractional values. Сведения о значениях см. в разделе "Параметры".See "Settings" for values.

UseParensForNegativeNumbers
TriState

Необязательный элемент.Optional. Константа TriState, указывающая, нужно ли заключать отрицательные значения в скобки.TriState constant that indicates whether or not to place negative values within parentheses. Сведения о значениях см. в разделе "Параметры".See "Settings" for values.

GroupDigits
TriState

Необязательный элемент.Optional. Константа TriState, указывающая, группируются ли значения с использованием разделителя, указанного в настройках языкового стандарта.TriState constant that indicates whether or not numbers are grouped using the group delimiter specified in the locale settings. Сведения о значениях см. в разделе "Параметры".See "Settings" for values.

Возвращаемое значение

Выражение в виде процента (умноженное на 100) с символом % в конце.An expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.

Исключения

Тип не является числовым.Type is not numeric.

Примеры

В этом примере показано использование функции FormatPercent.This example illustrates the use of the FormatPercent function.

Dim testNumber As Single = 0.76
' Returns "76.00%".
Dim testString As String = FormatPercent(testNumber)

Комментарии

При пропуске одного или нескольких необязательных аргументов значения пропущенных аргументов предоставляются параметрами языкового стандарта.When one or more optional arguments are omitted, the values for omitted arguments are provided by the locale settings.

Примечание

Все сведения о параметрах берутся из языкового стандарта приложения.All settings information comes from the locale of the application. По умолчанию это будет языковой стандарт, заданный на панели управления.By default, that will be the locale set in the control panel. Однако его можно изменить программно с помощью .NET Framework.However, it may be changed programmatically by using the .NET Framework.

Аргументы IncludeLeadingDigit, UseParensForNegativeNumbersи GroupDigits имеют следующие параметры.The IncludeLeadingDigit, UseParensForNegativeNumbers, and GroupDigits arguments have the following settings.

КонстантаConstant ОписаниеDescription
TriState.True ДаTrue
TriState.False FalseFalse
TriState.Default Региональные параметры компьютераThe computer's regional settings

Применяется к

Дополнительно