ValueType.ToString ValueType.ToString ValueType.ToString ValueType.ToString Method

Definition

Gibt den voll qualifizierten Typnamen dieser Instanz zurück.Returns the fully qualified type name of this instance.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

Der voll gekennzeichnete Typname.The fully qualified type name.

Hinweise

Die ValueType.ToString -Methode überschreibt Object.ToString die-Methode und stellt ToString die Standard Implementierung der-Methode für Werttypen bereit.The ValueType.ToString method overrides the Object.ToString method and provides the default implementation of the ToString method for value types. (Werttypen sind Typen, die struct durch das C#-Schlüsselwort in Structuredefiniert werden, und durch die... End Structure in Visual Basic erstellen.) Funktionell ist die Implementierung jedoch identisch mit der von Object.ToString: die Methode gibt den voll qualifizierten Typnamen zurück.(Value types are types defined by the struct keyword in C#, and by the Structure...End Structure construct in Visual Basic.) Functionally, however, the implementation is that same as that of Object.ToString: the method returns the fully qualified type name.

Durch das struct -Schlüsselwort definierte Werttypen Structurein C# und... Construct in Visual Basic in der Regel ValueType.ToString die-Methode überschreiben, um eine aussagekräftigere Zeichen folgen Darstellung des Werttyps bereitzustellen End StructureValue types defined by the struct keyword in C# and the Structure...End Structure construct in Visual Basic typically override the ValueType.ToString method to provide a more meaningful string representation of the value type. Der Unterschied wird im folgenden Beispiel veranschaulicht.The following example illustrates the difference. Es definiert zwei Werttypen EmployeeA , EmployeeBund, erstellt eine Instanz von jedem und ruft seine ToString -Methode auf.It defines two value types, EmployeeA and EmployeeB, creates an instance of each, and calls its ToString method. Da die EmployeeA -Struktur die ValueType.ToString -Methode nicht überschreibt, wird nur der voll qualifizierte Typname angezeigt.Because the EmployeeA structure does not override the ValueType.ToString method, it displays only the fully qualified type name. Die EmployeeB.ToString -Methode hingegen stellt sinnvolle Informationen über das-Objekt bereit.The EmployeeB.ToString method, on the other hand, provides meaningful information about the object.

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
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

Obwohl Enumerationstypen auch Werttypen sind, werden Sie von der Enum -Klasse abgeleitet, die ValueType.ToStringüberschreibt.Note that, although enumeration types are also value types, they derive from the Enum class, which overrides ValueType.ToString.

Hinweise für den Windows-RuntimeNotes for the Windows Runtime

Wenn Sie die ToString -Methode für eine Windows-RuntimeWindows Runtime -Struktur aufzurufen, wird das Standardverhalten für Werttypen ToStringbereitstellt, die nicht überschrieben werden.When you call the ToString method on a Windows-RuntimeWindows Runtime structure, it provides the default behavior for value types that don't override ToString. Dies ist ein Teil der Unterstützung, die der .NET Framework für Windows-RuntimeWindows Runtime bietet (siehe .NET Framework-Unterstützung für Windows Store-Apps und Windows-Runtime).This is part of the support that the .NET Framework provides for the Windows-RuntimeWindows Runtime (see .NET Framework Support for Windows Store Apps and Windows Runtime). Windows-RuntimeWindows RuntimeStrukturen können nicht ToStringaußer Kraft gesetzt werden, auch wenn C# Sie mit oder Visual Basic geschrieben sind, da Sie keine Methoden aufweisen können.structures can't override ToString, even if they're written with C# or Visual Basic, because they can't have methods. (Darüber hinaus erben Windows-RuntimeWindows Runtime ValueTypeStrukturen im selbst nicht.) Allerdings scheinen Sie die Methoden ToString, Equalsund GetHashCode zu haben, wenn Sie Sie im- C# oder-Visual Basic Code verwenden, und die .NET Framework stellt das Standardverhalten für diese Methoden bereit.(In addition, structures in the Windows-RuntimeWindows Runtime itself don't inherit ValueType.) However, they appear to have ToString, Equals, and GetHashCode methods when you use them in your C# or Visual Basic code, and the .NET Framework provides the default behavior for these methods.

Gilt für: