Object.ToString Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Parse
TryParse
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.