Object.ToString Metod

Definition

Namnområde:
System
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
netstandard.dll

Returnerar en sträng som representerar det aktuella objektet.

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

Returer

String

En sträng som representerar det aktuella objektet.

Kommentarer

Mer information om det här API:et finns i Kompletterande API-kommentarer för Object.ToString.

Anteckningar till arvingar

När du implementerar dina egna typer bör du åsidosätta ToString() metoden för att returnera värden som är meningsfulla för dessa typer. Härledda klasser som kräver mer kontroll över formatering än ToString() vad som finns kan implementera IFormattable gränssnittet. Med ToString(String, IFormatProvider) metoden kan du definiera formatsträngar som styr formateringen och använda ett IFormatProvider objekt som kan tillhandahålla kulturspecifik formatering.

Åsidosättningar av ToString() metoden bör följa dessa riktlinjer:

  • Den returnerade strängen bör vara vänlig och läsbar av människor.

  • Den returnerade strängen bör unikt identifiera värdet för objektinstansen.

  • Den returnerade strängen ska vara så kort som möjligt så att den är lämplig för visning av ett felsökningsprogram.

  • Åsidosättningen ToString() bör inte returneras Empty eller en null-sträng.

  • Åsidosättningen ToString() bör inte utlösa ett undantag.

  • Om strängrepresentationen av en instans är kulturkänslig eller kan formateras på flera sätt implementerar du IFormattable gränssnittet.

  • Om den returnerade strängen innehåller känslig information bör du först kräva en lämplig behörighet. Om efterfrågan lyckas kan du returnera känslig information. Annars bör du returnera en sträng som exkluderar känslig information.

  • Din ToString() åsidosättning bör inte ha några observerbara biverkningar för att undvika komplikationer vid felsökning. Ett anrop till ToString() metoden bör till exempel inte ändra värdet för instansfält.

  • Om din typ implementerar en parsningsmetod (eller ParseTryParse metod, konstruktor eller någon annan statisk metod som instansierar en instans av typen från en sträng), bör du se till att strängen ToString() som returneras av metoden kan konverteras till en objektinstans.

Gäller för

Se även