Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) 메서드

정의

시스템 제어판에 정의된 통화 기호를 사용하여 통화 값으로 서식이 지정된 식을 반환합니다.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);
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

필수 요소.Required. 서식이 지정될 식입니다.Expression to be formatted.

NumDigitsAfterDecimal
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

선택 사항입니다.Optional. 소수 값에서 앞에 오는 0을 표시할지 여부를 나타내는 TriState 열거형입니다.TriState enumeration that indicates whether or not a leading zero is displayed for fractional values. 값은 "설명"을 참조하십시오.See "Remarks" for values.

UseParensForNegativeNumbers
TriState

선택 사항입니다.Optional. 음수를 괄호로 묶을지 여부를 나타내는 TriState 열거형입니다.TriState enumeration that indicates whether or not to place negative values within parentheses. 값은 "설명"을 참조하십시오.See "Remarks" for values.

GroupDigits
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.

반환

String

시스템 제어판에 정의된 통화 기호를 사용하여 통화 값으로 서식이 지정된 식입니다.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. 그러나 탭에서 제공 하는 앞에 오는 0을 제외 하 고 .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 DescriptionDescription
TriState.True TrueTrue
TriState.False 거짓False
TriState.UseDefault 컴퓨터의 국가별 설정The computer's regional settings

적용 대상

추가 정보