IFormattable.ToString 메서드

아티클
08/21/2007

지정된 형식을 사용하여 현재 인스턴스 값의 형식을 지정합니다.

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

구문

‘선언
Function ToString ( _
    format As String, _
    formatProvider As IFormatProvider _
) As String
‘사용 방법
Dim instance As IFormattable
Dim format As String
Dim formatProvider As IFormatProvider
Dim returnValue As String

returnValue = instance.ToString(format, formatProvider)

string ToString (
    string format,
    IFormatProvider formatProvider
)

String^ ToString (
    String^ format, 
    IFormatProvider^ formatProvider
)

String ToString (
    String format, 
    IFormatProvider formatProvider
)

function ToString (
    format : String, 
    formatProvider : IFormatProvider
) : String

매개 변수

format
사용할 형식을 지정하는 String입니다.

- 또는 -

IFormattable 구현 형식에 대해 정의된 기본 형식을 사용하기 위한 Null 참조(Visual Basic의 경우 Nothing)입니다.

formatProvider
값의 형식을 지정하는 데 사용할 IFormatProvider입니다.

- 또는 -

운영 체제의 현재 로캘 설정에서 숫자 형식 정보를 가져오기 위한 Null 참조(Visual Basic의 경우 Nothing)입니다.

반환 값

지정된 형식의 현재 인스턴스 값이 포함된 String입니다.

설명

NumberFormatInfo , DateTimeFormatInfo 및 CultureInfo에서 IFormatProvider 인터페이스를 구현합니다.

NumberFormatInfo에서는 소수 구분 기호 및 1000단위 구분 기호에 사용할 문자와 금액 값의 통화 기호 철자 및 위치와 같은 숫자 형식 지정 정보를 제공합니다.

DateTimeFormatInfo에서는 날짜 패턴의 연, 월, 일 위치와 같은 날짜 및 시간 관련 형식 지정 정보를 제공합니다.

CultureInfo에는 숫자 형식 정보와 날짜 및 시간 관련 형식 지정 정보를 포함하여 특정 culture별 기본 형식 지정 정보가 포함되어 있습니다.

예제

다음 코드 예제에서는 ToString 메서드를 구현하는 방법을 보여 줍니다. 이 코드 예제는 IFormattable 클래스에 대해 제공되는 보다 큰 예제의 일부입니다.

public override String ToString() { return ToString(null, null); }

public String ToString(String format, IFormatProvider fp)
{
    // If no format is passed, display like this: (x, y).
    if (format == null) return String.Format("({0}, {1})", x, y);

    // For "x" formatting, return just the x value as a string
    if (format == "x") return x.ToString();

    // For "y" formatting, return just the y value as a string
    if (format == "y") return y.ToString();

    // For any unrecognized format, throw an exception.
    throw new FormatException(String.Format("Invalid format string: '{0}'.", format));
}

public:
    virtual String^ ToString() override
    {
        return ToString(nullptr, nullptr);
    }

public:
    virtual String^ ToString(String^ format, IFormatProvider^ formatProvider)
    {
        // If no format is passed, display like this: (x, y).
        if (format == nullptr)
        {
            return String::Format("({0}, {1})", x, y);
        }

        // For "x" formatting, return just the x value as a string
        if (format == "x")
        {
            return x.ToString();
        }

        // For "y" formatting, return just the y value as a string
        if (format == "y")
        {
            return y.ToString();
        }

        // For any unrecognized format, throw an exception.
        throw gcnew FormatException(String::Format(
            "Invalid format string: '{0}'.", format));
    }

플랫폼

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에서 지원

참고 항목

참조

IFormattable 인터페이스
IFormattable 멤버
System 네임스페이스
String
IFormatProvider 인터페이스
System.Globalization.NumberFormatInfo
System.Globalization.DateTimeFormatInfo
System.Globalization.CultureInfo

다음을 통해 공유