ValueType.ToString Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Quelle:

ValueType.cs

Gibt den voll qualifizierten Typnamen dieser Instanz zurück.

public:
 override System::String ^ ToString();

public override string? ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Gibt zurück

String

Der vollqualifizierte Typname.

Hinweise

Die ValueType.ToString -Methode überschreibt die Object.ToString -Methode und stellt die Standardimplementierung der ToString -Methode für Werttypen bereit. (Werttypen sind Typen, die durch die struct Schlüsselwort (keyword) in C# und durch ...StructureEnd Structure -Konstrukt in Visual Basic.) Funktionell ist die Implementierung jedoch identisch mit der von Object.ToString: Die Methode gibt den vollqualifizierten Typnamen zurück.

Werttypen, die struct vom Schlüsselwort (keyword) in C# und dem Structure...End Structure-Konstrukt in Visual Basic definiert werden, überschreiben in der Regel die ValueType.ToString -Methode, um eine aussagekräftigere Zeichenfolgendarstellung des Werttyps bereitzustellen. Der Unterschied wird im folgenden Beispiel veranschaulicht. Sie definiert zwei Werttypen, EmployeeA und EmployeeBerstellt jeweils eine instance und ruft die zugehörige ToString -Methode auf. Da die EmployeeA -Struktur die ValueType.ToString -Methode nicht überschreibt, wird nur der vollqualifizierte Typname angezeigt. Die EmployeeB.ToString -Methode hingegen liefert aussagekräftige Informationen über das -Objekt.

using System;
using Corporate.EmployeeObjects;

public class Example
{
   public static void Main()
   {
      var empA = new EmployeeA{ Name = "Robert",};
      Console.WriteLine(empA.ToString());
      
      var empB = new EmployeeB{ Name = "Robert",};
      Console.WriteLine(empB.ToString());
   }
}

namespace Corporate.EmployeeObjects
{
    public struct EmployeeA
    {
         public String Name { get; set; }
    }
    
    public struct EmployeeB
    {
         public String Name { get; set; }

         public override String ToString()
         {
              return Name;
         }
    }  
}
// The example displays the following output:
//     Corporate.EmployeeObjects.EmployeeA
//     Robert

namespace Corporate.EmployeeObjects

[<Struct>]
type EmployeeA =
    val mutable Name : string

[<Struct>]
type EmployeeB =
    val mutable Name : string
    override this.ToString() = 
          this.Name

module Example =
     let empA = EmployeeA(Name="Robert")
     printfn $"{empA}"

     let empB = EmployeeB(Name="Robert")
     printfn $"{empB}"
// The example displays the following output:
//     Corporate.EmployeeObjects.EmployeeA
//     Robert

Imports Corporate.EmployeeObjects

Module Example
   Public Sub Main()
      Dim empA As New EmployeeA With { .Name = "Robert" }
      Console.WriteLine(empA.ToString())
      
      Dim empB = new EmployeeB With { .Name = "Robert" }
      Console.WriteLine(empB.ToString())
   End Sub
End Module

Namespace Corporate.EmployeeObjects
    Public Structure EmployeeA
         Public Property Name As String 
    End Structure
    
    Public Structure EmployeeB
         Public Property Name As String 

         Public Overrides Function ToString() As String 
              Return Name
         End Function
    End Structure  
End Namespace
' The example displays the following output:
'     Corporate.EmployeeObjects.EmployeeA
'     Robert

Beachten Sie, dass Enumerationstypen zwar auch Werttypen sind, aber von der Enum -Klasse abgeleitet werden, die überschreibt ValueType.ToString.

Hinweise für die Windows-Runtime

Wenn Sie die ToString -Methode für eine Windows-Runtime-Struktur aufrufen, stellt sie das Standardverhalten für Werttypen bereit, die nicht überschreibenToString. Dies ist Teil der Unterstützung, die .NET für die Windows-Runtime bereitstellt (siehe .NET-Unterstützung für Windows Store-Apps und Windows-Runtime). Windows-Runtime Strukturen können nicht außer Kraft gesetzt ToStringwerden, auch wenn sie mit C# oder Visual Basic geschrieben wurden, da sie keine Methoden haben können. (Außerdem erben ValueTypeStrukturen im Windows-Runtime selbst nicht.) Sie scheinen jedoch methoden , Equalsund GetHashCode zu habenToString, wenn Sie sie in Ihrem C#- oder Visual Basic-Code verwenden, und .NET stellt das Standardverhalten für diese Methoden bereit.