ValueType.ToString Méthode

Définition

Retourne le nom de type qualifié complet de cette instance.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

Retours

Nom complet du type.The fully qualified type name.

Remarques

La méthode ValueType.ToString remplace la méthode Object.ToString et fournit l’implémentation par défaut de la méthode ToString pour les types valeur.The ValueType.ToString method overrides the Object.ToString method and provides the default implementation of the ToString method for value types. (Les types valeur sont des types définis par le mot clé @no__t C#-0 dans, et par la construction Structure... 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.(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.

Les types valeur définis par le mot clé @no__t- C# 0 dans et la construction Structure... End Structure dans Visual Basic substituent généralement la méthode ValueType.ToString pour fournir une représentation sous forme de chaîne plus significative du type valeur.Value 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. L'exemple suivant illustre la différence.The following example illustrates the difference. Il définit deux types valeur, EmployeeA et EmployeeB, crée une instance de chaque, puis appelle sa méthode ToString.It defines two value types, EmployeeA and EmployeeB, creates an instance of each, and calls its ToString method. Étant donné que la structure EmployeeA ne remplace pas la méthode ValueType.ToString, elle affiche uniquement le nom de type qualifié complet.Because the EmployeeA structure does not override the ValueType.ToString method, it displays only the fully qualified type name. La méthode EmployeeB.ToString, en revanche, fournit des informations significatives sur l’objet.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

Notez que, bien que les types énumération soient également des types valeur, ils dérivent de la classe Enum, qui remplace ValueType.ToString.Note that, although enumeration types are also value types, they derive from the Enum class, which overrides ValueType.ToString.

Notes pour le Windows RuntimeNotes for the Windows Runtime

Quand vous appelez la méthode ToString sur une structure Windows RuntimeWindows Runtime, elle fournit le comportement par défaut pour les types valeur qui ne remplacent pas ToString.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. Cela fait partie de la prise en charge fournie par le .NET Framework pour le Windows RuntimeWindows Runtime (consultez .NET Framework prise en charge des applications et des Windows Runtime du Windows Store).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). les structures Windows RuntimeWindows Runtime ne peuvent pas se substituer à ToString, même C# si elles sont écrites avec ou Visual Basic, car elles ne peuvent pas avoir de méthodes.Windows RuntimeWindows Runtime structures can't override ToString, even if they're written with C# or Visual Basic, because they can't have methods. (En outre, les structures dans le Windows RuntimeWindows Runtime n’héritent pas ValueType.) Toutefois, ils semblent avoir les méthodes ToString, Equals et GetHashCode lorsque vous les utilisez dans votre C# code ou Visual Basic, et le .NET Framework fournit le comportement par défaut pour ces méthodes.(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.

S’applique à