Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) Method

Определение

Возвращает выражение в формате денежной единицы с использованием символа денежной единицы, определенного в системной панели управления.Returns an expression formatted as a currency value using the currency symbol defined in the system control panel.

public static string FormatCurrency (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 FormatCurrency : obj * int * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState -> string
Public Function FormatCurrency (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 Object Object

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

NumDigitsAfterDecimal
Int32 Int32 Int32

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

IncludeLeadingDigit
TriState TriState TriState

Необязательный параметр.Optional. Перечисление TriState, указывающее, следует ли отображать ноль в начале дробных значений.TriState enumeration that indicates whether or not a leading zero is displayed for fractional values. Значения см. в разделе "Примечания".See "Remarks" for values.

UseParensForNegativeNumbers
TriState TriState TriState

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

GroupDigits
TriState TriState TriState

Необязательный параметр.Optional. Перечисление TriState, указывающее, следует ли объединять разряды чисел в группы, используя разделитель групп, определенный в региональных параметрах компьютера.TriState enumeration that indicates whether or not numbers are grouped using the group delimiter specified in the computer's regional settings. Значения см. в разделе "Примечания".See "Remarks" for values.

Возвраты

Выражение в формате денежной единицы с использованием символа денежной единицы, определенного в системной панели управления.An expression formatted as a currency value using the currency symbol defined in the system control panel.

Исключения

Число цифр после десятичного разделителя превышает 99.Number of digits after decimal point is greater than 99.

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

Примеры

В следующем примере показано применение функции FormatCurrency.The following example illustrates the use of the FormatCurrency function.

Dim testDebt As Double = -4456.43
Dim testString As String
' Returns "($4,456.43)".
testString = FormatCurrency(testDebt, , , TriState.True, TriState.True)

Комментарии

Если один или несколько необязательных аргументов опущены, вместо них используются соответствующие значения региональных параметров компьютера.When one or more optional arguments are omitted, the computer's matching regional-settings values are used instead.

Расположение символа валюты относительно значения валюты определяется региональными параметрами системы.The position of the currency symbol relative to the currency value is determined by the system's regional 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, за исключением начального нуля, которое поступает из вкладки Number.However, it may be changed programmatically by using the .NET Framework, except leading zero, which comes from the Number tab.

Аргументы IncludeLeadingDigit, UseParensForNegativeNumbers и GroupDigits принимают следующие значения перечисления TriState.The IncludeLeadingDigit, UseParensForNegativeNumbers, and GroupDigits arguments take the following TriState enumeration values.

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

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

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