Udostępnij za pośrednictwem


Object.ToString Metoda

Definicja

Zwraca ciąg reprezentujący bieżący obiekt.

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

Zwraca

Ciąg reprezentujący bieżący obiekt.

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla obiektu Object.ToString.

Uwagi dotyczące dziedziczenia

Podczas implementowania własnych typów należy zastąpić metodę ToString() , aby zwracać wartości, które mają znaczenie dla tych typów. Klasy pochodne, które wymagają większej kontroli nad formatowaniem niż ToString() zapewnia, mogą implementować IFormattable interfejs. Metoda ToString(String, IFormatProvider) umożliwia definiowanie ciągów formatu kontrolujących formatowanie i używanie IFormatProvider obiektu, który może zapewnić formatowanie specyficzne dla kultury.

Zastąpienia metody powinny być zgodne z ToString() następującymi wytycznymi:

  • Zwrócony ciąg powinien być przyjazny i czytelny dla ludzi.

  • Zwrócony ciąg powinien jednoznacznie identyfikować wartość wystąpienia obiektu.

  • Zwrócony ciąg powinien być możliwie najkrótszy, aby był odpowiedni do wyświetlania przez debuger.

  • Przesłonięcia ToString() nie powinny zwracać Empty ani ciągu o wartości null.

  • Przesłonięcia ToString() nie powinny zgłaszać wyjątku.

  • Jeśli reprezentacja ciągu wystąpienia jest wrażliwa na kulturę lub może być sformatowana na wiele sposobów, zaimplementuj IFormattable interfejs.

  • Jeśli zwracany ciąg zawiera informacje poufne, należy najpierw zażądać odpowiedniego uprawnienia. Jeśli zapotrzebowanie powiedzie się, możesz zwrócić poufne informacje; W przeciwnym razie należy zwrócić ciąg, który wyklucza poufne informacje.

  • Przesłonięcia ToString() nie powinny mieć zauważalnych skutków ubocznych, aby uniknąć komplikacji w debugowaniu. Na przykład wywołanie ToString() metody nie powinno zmieniać wartości pól wystąpienia.

  • Jeśli typ implementuje metodę analizowania (lub ParseTryParse metodę, konstruktora lub inną metodę statyczną, która tworzy wystąpienie typu z ciągu), upewnij się, że ciąg zwrócony przez ToString() metodę może zostać przekonwertowany na wystąpienie obiektu.

Dotyczy

Zobacz też