Object.ToString 메서드

정의

네임스페이스:
System
어셈블리:
mscorlib.dll, System.Runtime.dll
어셈블리:
mscorlib.dll
어셈블리:
System.Runtime.dll
어셈블리:
netstandard.dll

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

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

반품

String

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

설명

이 API에 대한 자세한 내용은 Object.ToString에 대한 추가 API 비고를 참조하세요.

상속자 참고

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

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

  • 반환된 문자열은 인간이 친숙하고 읽을 수 있어야 합니다.

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

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

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

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

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

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

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

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

적용 대상

추가 정보