Object.ToString Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een tekenreeks die het huidige object vertegenwoordigt.
public:
virtual System::String ^ ToString();public virtual string ToString();abstract member ToString : unit -> string
override this.ToString : unit -> stringPublic Overridable Function ToString () As StringRetouren
Een tekenreeks die het huidige object vertegenwoordigt.
Opmerkingen
Zie Aanvullende API-opmerkingen voor Object.ToString voor meer informatie over deze API.
Notities voor overnemers
Wanneer u uw eigen typen implementeert, moet u de ToString() methode overschrijven om waarden te retourneren die zinvol zijn voor deze typen. Afgeleide klassen die meer controle over opmaak vereisen dan ToString() biedt, kunnen de IFormattable interface implementeren. Met ToString(String, IFormatProvider) de methode kunt u opmaaktekenreeksen definiëren die de opmaak bepalen en een IFormatProvider object gebruiken dat kan voorzien in cultuurspecifieke opmaak.
Onderdrukkingen van de ToString() methode moeten de volgende richtlijnen volgen:
De geretourneerde tekenreeks moet vriendelijk en leesbaar zijn voor mensen.
De geretourneerde tekenreeks moet de waarde van het objectexemplaren uniek identificeren.
De geretourneerde tekenreeks moet zo kort mogelijk zijn, zodat deze geschikt is voor weergave door een foutopsporingsprogramma.
Uw ToString() overschrijving mag niet worden geretourneerd Empty of een null-tekenreeks.
Uw ToString() onderdrukking mag geen uitzondering genereren.
Als de tekenreeksweergave van een exemplaar cultuurgevoelig is of op meerdere manieren kan worden opgemaakt, implementeert u de IFormattable interface.
Als de geretourneerde tekenreeks gevoelige informatie bevat, moet u eerst een juiste machtiging vragen. Als de vraag slaagt, kunt u de gevoelige informatie retourneren; Anders moet u een tekenreeks retourneren die de gevoelige informatie uitsluit.
Uw ToString() onderdrukking mag geen waarneembare bijwerkingen hebben om complicaties bij het opsporen van fouten te voorkomen. Een aanroep naar de ToString() methode mag bijvoorbeeld de waarde van exemplaarvelden niet wijzigen.
Als uw type een parseringsmethode (of
ParseTryParsemethode, een constructor of een andere statische methode implementeert waarmee een exemplaar van het type van een tekenreeks wordt geïnstitueerd), moet u ervoor zorgen dat de tekenreeks die door de ToString() methode wordt geretourneerd, kan worden geconverteerd naar een objectexemplaren.