다음을 통해 공유


Object.ToString 메서드

정의

현재 개체를 나타내는 문자열을 반환합니다.

public:
 virtual System::String ^ ToString();
public virtual string ToString ();
public virtual string? ToString ();
abstract member ToString : unit -> string
override this.ToString : unit -> string
Public Overridable Function ToString () As String

반환

현재 개체를 나타내는 문자열입니다.

설명

이 API에 대한 자세한 내용은 Object.ToString에 대한 추가 API 설명을 참조하세요.

상속자 참고

고유한 형식을 구현하는 경우 메서드를 재정의 ToString() 하여 해당 형식에 의미 있는 값을 반환해야 합니다. 에서 제공하는 것보다 ToString() 서식을 더 많이 제어해야 하는 파생 클래스는 인터페이스를 구현할 IFormattable 수 있습니다. 해당 ToString(String, IFormatProvider) 메서드를 사용하면 서식을 제어하는 형식 문자열을 정의하고 문화권별 서식을 제공할 수 있는 개체를 사용할 IFormatProvider 수 있습니다.

메서드 재정의는 ToString() 다음 지침을 따라야 합니다.

  • 반환된 문자열은 사용자에게 친숙하고 읽을 수 있어야 합니다.

  • 반환된 문자열은 개체 instance 값을 고유하게 식별해야 합니다.

  • 반환된 문자열은 디버거에서 표시하는 데 적합할 수 있도록 가능한 한 짧아야 합니다.

  • ToString() 재정의는 또는 null 문자열을 반환 Empty 해서는 안 됩니다.

  • ToString() 재정의는 예외를 throw해서는 안 됩니다.

  • instance 문자열 표현이 문화권을 구분하거나 여러 가지 방법으로 서식을 지정할 수 있는 경우 인터페이스를 구현합니다IFormattable.

  • 반환된 문자열에 중요한 정보가 포함된 경우 먼저 적절한 권한을 요구해야 합니다. 수요가 성공하면 중요한 정보를 반환할 수 있습니다. 그렇지 않으면 중요한 정보를 제외하는 문자열을 반환해야 합니다.

  • 재정 ToString() 의는 디버깅에서 합병증을 피하기 위해 관찰 가능한 부작용이 없어야 합니다. 예를 들어 메서드를 호출하면 ToString() instance 필드의 값이 변경되지 않아야 합니다.

  • 형식이 구문 분석 메서드(또는 ParseTryParse 메서드, 생성자 또는 문자열에서 형식의 instance 인스턴스화하는 다른 정적 메서드)를 구현하는 경우 메서드에서 반환된 ToString() 문자열을 개체 instance 변환할 수 있는지 확인해야 합니다.

적용 대상

추가 정보