ICustomFormatter.Format 메서드

아티클
08/21/2007

지정된 형식 및 culture별 형식 지정 정보를 사용하여 지정된 개체의 값을 해당하는 문자열로 변환합니다.

네임스페이스: System
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
Function Format ( _
    format As String, _
    arg As Object, _
    formatProvider As IFormatProvider _
) As String
‘사용 방법
Dim instance As ICustomFormatter
Dim format As String
Dim arg As Object
Dim formatProvider As IFormatProvider
Dim returnValue As String

returnValue = instance.Format(format, arg, formatProvider)

string Format (
    string format,
    Object arg,
    IFormatProvider formatProvider
)

String^ Format (
    String^ format, 
    Object^ arg, 
    IFormatProvider^ formatProvider
)

String Format (
    String format, 
    Object arg, 
    IFormatProvider formatProvider
)

function Format (
    format : String, 
    arg : Object, 
    formatProvider : IFormatProvider
) : String

매개 변수

format
형식 지정 사양을 포함하는 형식 문자열입니다.

arg
형식을 지정할 개체입니다.

formatProvider
현재 인스턴스에 대한 형식 정보를 제공하는 IFormatProvider 개체입니다.

반환 값

format 및 formatProvider에서 지정한 대로 형식이 지정된 arg 값을 문자열로 나타낸 것입니다.

설명

format 매개 변수는 사용자 정의 형식 지정 사양을 포함합니다. 표준 .NET Framework 형식 지정 사양에 대한 자세한 내용은 형식 지정 개요를 참조하십시오.

format이 Null 참조(Visual Basic의 경우 Nothing)인 경우 선택한 기본 형식 사양을 사용합니다. formatProvider가 Null 참조(Visual Basic의 경우 Nothing)인 경우 해당 매개 변수를 무시합니다.

구현한 Format 메서드에는 사용자가 지원하지 않는 형식을 .NET Framework에서 지정할 수 있도록 다음 기능이 포함되어 있어야 합니다. 형식 메서드가 특정 형식을 지원하지 않으면 형식을 지정하고 있는 개체가 IFormattable 인터페이스를 구현하는지의 여부를 확인하십시오. 구현하는 경우에는 해당 인터페이스의 IFormattable.ToString 메서드를 호출합니다. 그렇지 않으면 내부 개체의 기본 Object.ToString 메서드를 호출합니다.

다음은 arg 개체, format 형식, formatProvider 형식 공급자 및 반환 값 s에 대해 이러한 패턴을 보여 주는 C# 코드의 한 부분입니다.

if (arg is IFormattable) s = ((IFormattable)arg).ToString(format, formatProvider);

else if (arg != null) s = arg.ToString();

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

ICustomFormatter 인터페이스
ICustomFormatter 멤버
System 네임스페이스
IFormattable
Object

다음을 통해 공유