FormatPercent 함수(Visual Basic)

업데이트: 2007년 11월

뒤에 % 문자를 붙이고 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
  선택적 요소. 소수 값에서 앞에 오는 0을 표시할지 여부를 나타내는 TriState 상수입니다. 값에 대해서는 "설정"을 참조하십시오.

• UseParensForNegativeNumbers
  선택적 요소. 음수를 괄호로 묶을지 여부를 나타내는 TriState 상수입니다. 값에 대해서는 "설정"을 참조하십시오.

• GroupDigits
  선택적 요소. 로캘 설정에 지정된 그룹 구분 기호를 사용하여 숫자를 그룹화할지 여부를 나타내는 TriState 상수입니다. 값에 대해서는 "설정"을 참조하십시오.

설정

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