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

Definição

Retorna o nome do tipo totalmente qualificado dessa instância.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

Retornos

O nome de tipo totalmente qualificado.The fully qualified type name.

Comentários

O ValueType.ToString substituições de método de Object.ToString método e fornece a implementação padrão da ToString método para tipos de valor.The ValueType.ToString method overrides the Object.ToString method and provides the default implementation of the ToString method for value types. (Tipos de valor são tipos definidos pelo struct palavra-chave em c# e pela Structure... End Structure construir no Visual Basic.) Funcionalmente, no entanto, a implementação é que mesmo de Object.ToString: o método retorna o nome de tipo totalmente qualificado.(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.

Valor de tipos definidos pelo struct palavra-chave em c# e o Structure... End Structure construção no Visual Basic normalmente substitui o ValueType.ToString método para fornecer uma representação de cadeia de caracteres mais significativa do tipo de valor.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. O exemplo a seguir ilustra a diferença.The following example illustrates the difference. Ele define dois tipos de valor EmployeeA e EmployeeB, cria uma instância de cada e chama seu ToString método.It defines two value types, EmployeeA and EmployeeB, creates an instance of each, and calls its ToString method. Porque o EmployeeA estrutura não substitui o ValueType.ToString método, ele exibe apenas o nome de tipo totalmente qualificado.Because the EmployeeA structure does not override the ValueType.ToString method, it displays only the fully qualified type name. O EmployeeB.ToString método, por outro lado, fornece informações significativas sobre o objeto.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

Observe que, embora os tipos de enumeração também são tipos de valor, eles derivam de Enum classe, que substitui ValueType.ToString.Note that, although enumeration types are also value types, they derive from the Enum class, which overrides ValueType.ToString.

Notas para o tempo de execução do WindowsNotes for the Windows Runtime

Quando você chama o ToString método em um Tempo de Execução do WindowsWindows Runtime estrutura, ele fornece o comportamento padrão para tipos de valor que não substituem ToString.When you call the ToString method on a Tempo de Execução do WindowsWindows Runtime structure, it provides the default behavior for value types that don't override ToString. Isso faz parte do suporte fornecido pelo .NET Framework para o Tempo de Execução do WindowsWindows Runtime (consulte tempo de execução do Windows e de aplicativos .NET Framework dão suporte para Windows Store).This is part of the support that the .NET Framework provides for the Tempo de Execução do WindowsWindows Runtime (see .NET Framework Support for Windows Store Apps and Windows Runtime). Tempo de Execução do WindowsWindows Runtime estruturas não podem substituir ToString, mesmo se eles são escritos com C# ou Visual Basic, porque eles não podem ter métodos.structures can't override ToString, even if they're written with C# or Visual Basic, because they can't have methods. (Além disso, as estruturas na Tempo de Execução do WindowsWindows Runtime em si não herdam ValueType.) No entanto, eles parecem ter ToString, Equals, e GetHashCode métodos quando usá-los em seu código c# ou Visual Basic e o .NET Framework fornece o comportamento padrão para esses métodos.(In addition, structures in the Tempo de Execução do WindowsWindows 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.

Aplica-se a