Baca dalam bahasa Inggris

Bagikan melalui


ValueType.ToString Metode

Definisi

Mengembalikan nama jenis instans ini yang sepenuhnya memenuhi syarat.

C#
public override string ToString();
C#
public override string? ToString();

Mengembalikan

Nama jenis yang sepenuhnya memenuhi syarat.

Keterangan

Metode ini ValueType.ToString mengambil alih Object.ToString metode dan menyediakan implementasi ToString default metode untuk jenis nilai. (Jenis nilai adalah jenis yang ditentukan oleh struct kata kunci di C#, dan oleh Structurekonstruksi ...End Structure di Visual Basic.) Namun, secara fungsional, implementasinya sama Object.ToStringdengan : metode mengembalikan nama jenis yang sepenuhnya memenuhi syarat.

Jenis nilai yang ditentukan oleh struct kata kunci dalam C# dan Structurekonstruksi ...End Structure di Visual Basic biasanya mengambil alih ValueType.ToString metode untuk memberikan representasi string yang lebih bermakna dari jenis nilai. Contoh berikut mengilustrasikan perbedaannya. Ini mendefinisikan dua jenis nilai, EmployeeA dan EmployeeB, membuat instans masing-masing, dan memanggil metodenya ToString . EmployeeA Karena struktur tidak mengambil alih ValueType.ToString metode, struktur hanya menampilkan nama jenis yang sepenuhnya memenuhi syarat. Metode ini EmployeeB.ToString , di sisi lain, memberikan informasi yang bermakna tentang objek .

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

Perhatikan bahwa, meskipun jenis enumerasi juga merupakan jenis nilai, jenis tersebut Enum berasal dari kelas , yang mengambil alih ValueType.ToString.

Catatan untuk Windows Runtime

Ketika Anda memanggil ToString metode pada struktur Windows Runtime, metode ini menyediakan perilaku default untuk jenis nilai yang tidak mengambil alih ToString. Ini adalah bagian dari dukungan yang disediakan .NET untuk Windows Runtime (lihat Dukungan .NET untuk Aplikasi Windows Store dan Windows Runtime). Struktur Windows Runtime tidak dapat mengambil alih ToString, meskipun ditulis dengan C# atau Visual Basic, karena tidak dapat memiliki metode. (Selain itu, struktur dalam Windows Runtime itu sendiri tidak mewarisi ValueType.) Namun, mereka tampaknya memiliki ToStringmetode , Equals, dan GetHashCode ketika Anda menggunakannya dalam kode C# atau Visual Basic Anda, dan .NET menyediakan perilaku default untuk metode ini.

Berlaku untuk

Produk Versi
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0