ValueType.ToString Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Retourne le nom de type qualifié complet de cette instance.

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

public override string ToString ();

public override string? ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retours

String

Nom complet du type.

Remarques

La ValueType.ToString méthode substitue la Object.ToString méthode et fournit l’implémentation par défaut de la ToString méthode pour les types valeur. (Les types valeur sont des types définis par le struct mot clé en C#, et par la Structure construction... End Structure dans Visual Basic.) Toutefois, le fonctionnement de l’implémentation est le même que celui de Object.ToString : la méthode retourne le nom de type qualifié complet.

les types valeur définis par le struct mot clé en C# et la Structure construction... End Structure dans Visual Basic substituent généralement la ValueType.ToString méthode pour fournir une représentation sous forme de chaîne plus significative du type valeur. L'exemple suivant illustre la différence. Il définit deux types valeur, EmployeeA et EmployeeB , crée une instance de chaque, puis appelle sa ToString méthode. Étant donné que la EmployeeA structure ne remplace pas la ValueType.ToString méthode, elle affiche uniquement le nom de type qualifié complet. EmployeeB.ToStringEn revanche, la méthode fournit des informations significatives sur l’objet.

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

Notez que, bien que les types énumération soient également des types valeur, ils dérivent de la Enum classe, qui remplace ValueType.ToString .

Notes pour le Windows Runtime

quand vous appelez la ToString méthode sur une structure Windows Runtime, elle fournit le comportement par défaut pour les types valeur qui ne remplacent pas ToString . cela fait partie de la prise en charge fournie par le .NET Framework pour le Windows Runtime (consultez .NET Framework prise en charge Windows des applications du windows Store et des Windows Runtime). les structures de Windows Runtime ne peuvent pas être substituées ToString , même si elles sont écrites en C# ou Visual Basic, car elles ne peuvent pas avoir de méthodes. (en outre, les structures dans le Windows Runtime lui-même n’héritent pas ValueType .) toutefois, ils semblent avoir des ToString Equals méthodes, et GetHashCode lorsque vous les utilisez dans votre code C# ou Visual Basic, et le .NET Framework fournit le comportement par défaut pour ces méthodes.