Bagikan melalui


Enum.ToString Metode

Definisi

Mengonversi nilai instans ini ke representasi string yang setara.

Overload

ToString(String, IFormatProvider)
Kedaluwarsa.
Kedaluwarsa.

Metode ini kelebihan beban sudah usang; gunakan ToString(String).

ToString()

Mengonversi nilai instans ini ke representasi string yang setara.

ToString(String)

Mengonversi nilai instans ini ke representasi string yang setara menggunakan format yang ditentukan.

ToString(IFormatProvider)
Kedaluwarsa.
Kedaluwarsa.

Metode ini kelebihan beban sudah usang; gunakan ToString().

ToString(String, IFormatProvider)

Sumber:
Enum.cs
Sumber:
Enum.cs
Sumber:
Enum.cs

Perhatian

The provider argument is not used. Please use ToString(String).

Perhatian

The provider argument is not used. Use ToString(String) instead.

Metode ini kelebihan beban sudah usang; gunakan ToString(String).

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
[System.Obsolete("The provider argument is not used. Please use ToString(String).")]
public string ToString (string? format, IFormatProvider? provider);
[System.Obsolete("The provider argument is not used. Use ToString(String) instead.")]
public string ToString (string? format, IFormatProvider? provider);
[System.Obsolete("The provider argument is not used. Please use ToString(String).")]
public string ToString (string format, IFormatProvider provider);
public string ToString (string format, IFormatProvider provider);
[<System.Obsolete("The provider argument is not used. Please use ToString(String).")>]
override this.ToString : string * IFormatProvider -> string
[<System.Obsolete("The provider argument is not used. Use ToString(String) instead.")>]
override this.ToString : string * IFormatProvider -> string
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parameter

format
String

Spesifikasi format.

provider
IFormatProvider

(Usang.)

Mengembalikan

Representasi string dari nilai instans ini seperti yang ditentukan oleh format.

Penerapan

Atribut

Pengecualian

format tidak berisi spesifikasi format yang valid.

format sama dengan "X", tetapi jenis enumerasi tidak diketahui.

Keterangan

Parameter format dapat menjadi salah satu string format berikut: "G" atau "g", "D" atau "d", "X" atau "x", dan "F" atau "f" (string format tidak peka huruf besar/kecil). Jika format adalah null atau string kosong (""), penentu format umum ("G") digunakan. Untuk informasi selengkapnya tentang string format enumerasi dan nilai enumerasi pemformatan, lihat String Format Enumerasi. Untuk informasi selengkapnya tentang pemformatan secara umum, lihat Tipe Pemformatan.

Tentukan saja format; provider parameter sudah usang.

Lihat juga

Berlaku untuk

ToString()

Sumber:
Enum.cs
Sumber:
Enum.cs
Sumber:
Enum.cs

Mengonversi nilai instans ini ke representasi string yang setara.

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

Mengembalikan

Representasi string dari nilai instans ini.

Contoh

Contoh berikut menunjukkan konversi nilai enumerasi menjadi string.

using namespace System;
public ref class EnumSample
{
public:
   enum class Colors
   {
      Red = 1,
      Blue = 2
   };

   static void main()
   {
      Enum ^ myColors = Colors::Red;
      Console::WriteLine( "The value of this instance is '{0}'", myColors );
   }

};

int main()
{
   EnumSample::main();
}

/*
Output.
The value of this instance is 'Red'.
*/
using System;

public class EnumSample {
    enum Colors {Red = 1, Blue = 2};

    public static void Main() {
        Enum myColors = Colors.Red;
        Console.WriteLine("The value of this instance is '{0}'",
           myColors.ToString());
    }
}
/*
Output.
The value of this instance is 'Red'.
*/
type Colors =
    | Red = 1
    | Blue = 2

let myColors = Colors.Red
printfn $"The value of this instance is '{myColors.ToString()}'"

// Output.
// The value of this instance is 'Red'.
Public Class EnumSample    
    Enum Colors
        Red = 1
        Blue = 2
    End Enum
    
    Public Shared Sub Main()
        Dim myColors As Colors = Colors.Red
        Console.WriteLine("The value of this instance is '{0}'", _
           myColors.ToString())
    End Sub
End Class

'Output.
'The value of this instance is 'Red'.

Keterangan

Nilai yang dikembalikan diformat dengan penentu format umum ("G"). Artinya, jika FlagsAttribute tidak diterapkan ke jenis enumerasi ini dan ada konstanta bernama yang sama dengan nilai instans ini, maka nilai yang dikembalikan adalah string yang berisi nama konstanta. FlagsAttribute Jika diterapkan dan ada kombinasi satu atau beberapa konstanta bernama yang sama dengan nilai instans ini, maka nilai yang dikembalikan adalah string yang berisi daftar nama konstanta yang dipisahkan pemisah. Jika tidak, nilai yang dikembalikan adalah representasi string dari nilai numerik instans ini. Untuk informasi selengkapnya tentang nilai enumerasi pemformatan, lihat String Format Enumerasi. Untuk informasi selengkapnya tentang pemformatan secara umum, lihat Tipe Pemformatan.

Catatan Bagi Pemanggil

Jika beberapa anggota enumerasi memiliki nilai dasar yang sama dan Anda mencoba mengambil representasi string dari nama anggota enumerasi berdasarkan nilai yang mendasarnya, kode Anda tidak boleh membuat asumsi tentang nama mana yang akan dikembalikan metode. Misalnya, enumerasi berikut mendefinisikan dua anggota, Shade.Gray dan Shade.Grey, yang memiliki nilai mendasar yang sama.

enum Shade
{
    White = 0, Gray = 1, Grey = 1, Black = 2
}
type Shade =
    | White = 0
    | Gray = 1
    | Grey = 1
    | Black = 2
Public Enum Shade
   White = 0
   Gray = 1
   Grey = 1
   Black = 2
End Enum

Panggilan metode berikut mencoba mengambil nama anggota Shade enumerasi yang nilai mendasarnya adalah 1. Metode ini dapat mengembalikan "Abu-abu" atau "Abu-abu", dan kode Anda tidak boleh membuat asumsi tentang string mana yang akan dikembalikan.

string shadeName = ((Shade) 1).ToString();
let shadeName = (enum<Shade> 1).ToString()
Dim shadeName As String = CType(1, Shade).ToString()

Lihat juga

Berlaku untuk

ToString(String)

Sumber:
Enum.cs
Sumber:
Enum.cs
Sumber:
Enum.cs

Mengonversi nilai instans ini ke representasi string yang setara menggunakan format yang ditentukan.

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

Parameter

format
String

String format.

Mengembalikan

Representasi string dari nilai instans ini seperti yang ditentukan oleh format.

Pengecualian

format berisi spesifikasi yang tidak valid.

format sama dengan "X", tetapi jenis enumerasi tidak diketahui.

Contoh

Contoh berikut menunjukkan cara mengonversi nilai enumerasi menjadi string.

// Sample for Enum::ToString(String)

using namespace System;

public enum class Colors
{
   Red, Green, Blue, Yellow = 12
};

int main()
{
   Colors myColor = Colors::Yellow;
   Console::WriteLine( "Colors::Red = {0}", Colors::Red.ToString( "d" ) );
   Console::WriteLine( "Colors::Green = {0}", Colors::Green.ToString( "d" ) );
   Console::WriteLine( "Colors::Blue = {0}", Colors::Blue.ToString( "d" ) );
   Console::WriteLine( "Colors::Yellow = {0}", Colors::Yellow.ToString( "d" ) );
   Console::WriteLine( " {0}myColor = Colors::Yellow {0}", Environment::NewLine );
   Console::WriteLine( "myColor->ToString(\"g\") = {0}", myColor.ToString( "g" ) );
   Console::WriteLine( "myColor->ToString(\"G\") = {0}", myColor.ToString( "G" ) );
   Console::WriteLine( "myColor->ToString(\"x\") = {0}", myColor.ToString( "x" ) );
   Console::WriteLine( "myColor->ToString(\"X\") = {0}", myColor.ToString( "X" ) );
   Console::WriteLine( "myColor->ToString(\"d\") = {0}", myColor.ToString( "d" ) );
   Console::WriteLine( "myColor->ToString(\"D\") = {0}", myColor.ToString( "D" ) );
   Console::WriteLine( "myColor->ToString(\"f\") = {0}", myColor.ToString( "f" ) );
   Console::WriteLine( "myColor->ToString(\"F\") = {0}", myColor.ToString( "F" ) );
}

/*
This example produces the following results:
Colors::Red = 0
Colors::Green = 1
Colors::Blue = 2
Colors::Yellow = 12

myColor = Colors::Yellow

myColor->ToString("g") = Yellow
myColor->ToString("G") = Yellow
myColor->ToString("x") = 0000000C
myColor->ToString("X") = 0000000C
myColor->ToString("d") = 12
myColor->ToString("D") = 12
myColor->ToString("f") = Yellow
myColor->ToString("F") = Yellow
*/
// Sample for Enum.ToString(String)
using System;

class Sample
{
    enum Colors {Red, Green, Blue, Yellow = 12};

    public static void Main()
    {
    Colors myColor = Colors.Yellow;

    Console.WriteLine("Colors.Red = {0}", Colors.Red.ToString("d"));
    Console.WriteLine("Colors.Green = {0}", Colors.Green.ToString("d"));
    Console.WriteLine("Colors.Blue = {0}", Colors.Blue.ToString("d"));
    Console.WriteLine("Colors.Yellow = {0}", Colors.Yellow.ToString("d"));

    Console.WriteLine("{0}myColor = Colors.Yellow{0}", Environment.NewLine);

    Console.WriteLine("myColor.ToString(\"g\") = {0}", myColor.ToString("g"));
    Console.WriteLine("myColor.ToString(\"G\") = {0}", myColor.ToString("G"));

    Console.WriteLine("myColor.ToString(\"x\") = {0}", myColor.ToString("x"));
    Console.WriteLine("myColor.ToString(\"X\") = {0}", myColor.ToString("X"));

    Console.WriteLine("myColor.ToString(\"d\") = {0}", myColor.ToString("d"));
    Console.WriteLine("myColor.ToString(\"D\") = {0}", myColor.ToString("D"));

    Console.WriteLine("myColor.ToString(\"f\") = {0}", myColor.ToString("f"));
    Console.WriteLine("myColor.ToString(\"F\") = {0}", myColor.ToString("F"));
    }
}
/*
This example produces the following results:
Colors.Red = 0
Colors.Green = 1
Colors.Blue = 2
Colors.Yellow = 12

myColor = Colors.Yellow

myColor.ToString("g") = Yellow
myColor.ToString("G") = Yellow
myColor.ToString("x") = 0000000C
myColor.ToString("X") = 0000000C
myColor.ToString("d") = 12
myColor.ToString("D") = 12
myColor.ToString("f") = Yellow
myColor.ToString("F") = Yellow
*/
// Sample for Enum.ToString(String)
open System

type Colors =
    | Red = 0 
    | Green = 1 
    | Blue = 2 
    | Yellow = 12

let myColor = Colors.Yellow

printfn $"""Colors.Red = {Colors.Red.ToString "d"}"""
printfn $"""Colors.Green = {Colors.Green.ToString "d"}"""
printfn $"""Colors.Blue = {Colors.Blue.ToString "d"}"""
printfn $"""Colors.Yellow = {Colors.Yellow.ToString "d"}"""

printfn "\nmyColor = Colors.Yellow\n"

printfn $"""myColor.ToString("g") = {myColor.ToString "g"}"""
printfn $"""myColor.ToString("G") = {myColor.ToString "G"}"""

printfn $"""myColor.ToString("x") = {myColor.ToString "x"}"""
printfn $"""myColor.ToString("X") = {myColor.ToString "X"}"""

printfn $"""myColor.ToString("d") = {myColor.ToString "d"}"""
printfn $"""myColor.ToString("D") = {myColor.ToString "d"}"""

printfn $"""myColor.ToString("f") = {myColor.ToString "f"}"""
printfn $"""myColor.ToString("F") = {myColor.ToString "F"}"""

// This example produces the following results:
//     Colors.Red = 0
//     Colors.Green = 1
//     Colors.Blue = 2
//     Colors.Yellow = 12
//    
//     myColor = Colors.Yellow
//    
//     myColor.ToString("g") = Yellow
//     myColor.ToString("G") = Yellow
//     myColor.ToString("x") = 0000000C
//     myColor.ToString("X") = 0000000C
//     myColor.ToString "d" = 12
//     myColor.ToString "d" = 12
//     myColor.ToString("f") = Yellow
//     myColor.ToString("F") = Yellow
' Sample for Enum.ToString(String)
Class Sample
   Enum Colors
      Red
      Green
      Blue
      Yellow = 12
   End Enum 'Colors
   
   Public Shared Sub Main()
      Dim myColor As Colors = Colors.Yellow
      
      Console.WriteLine("Colors.Red = {0}", Colors.Red.ToString("d"))
      Console.WriteLine("Colors.Green = {0}", Colors.Green.ToString("d"))
      Console.WriteLine("Colors.Blue = {0}", Colors.Blue.ToString("d"))
      Console.WriteLine("Colors.Yellow = {0}", Colors.Yellow.ToString("d"))
      
      Console.WriteLine("{0}myColor = Colors.Yellow{0}", Environment.NewLine)
      
      Console.WriteLine("myColor.ToString(""g"") = {0}", myColor.ToString("g"))
      Console.WriteLine("myColor.ToString(""G"") = {0}", myColor.ToString("G"))
      
      Console.WriteLine("myColor.ToString(""x"") = {0}", myColor.ToString("x"))
      Console.WriteLine("myColor.ToString(""X"") = {0}", myColor.ToString("X"))
      
      Console.WriteLine("myColor.ToString(""d"") = {0}", myColor.ToString("d"))
      Console.WriteLine("myColor.ToString(""D"") = {0}", myColor.ToString("D"))
      
      Console.WriteLine("myColor.ToString(""f"") = {0}", myColor.ToString("f"))
      Console.WriteLine("myColor.ToString(""F"") = {0}", myColor.ToString("F"))
   End Sub
End Class
'
'This example produces the following results:
'
'Colors.Red = 0
'Colors.Green = 1
'Colors.Blue = 2
'Colors.Yellow = 12
'
'myColor = Colors.Yellow
'
'myColor.ToString("g") = Yellow
'myColor.ToString("G") = Yellow
'myColor.ToString("x") = 0000000C
'myColor.ToString("X") = 0000000C
'myColor.ToString("d") = 12
'myColor.ToString("D") = 12
'myColor.ToString("f") = Yellow
'myColor.ToString("F") = Yellow
'

Keterangan

Parameter format dapat menjadi salah satu string format berikut: "G" atau "g", "D" atau "d", "X" atau "x", dan "F" atau "f" (string format tidak peka huruf besar/kecil). Jika format adalah null atau string kosong (""), penentu format umum ("G") digunakan. Untuk informasi selengkapnya tentang string format enumerasi dan nilai enumerasi pemformatan, lihat String Format Enumerasi. Untuk informasi selengkapnya tentang pemformatan secara umum, lihat Tipe Pemformatan.

Catatan Bagi Pemanggil

Jika beberapa anggota enumerasi memiliki nilai dasar yang sama dan Anda mencoba mengambil representasi string dari nama anggota enumerasi berdasarkan nilai yang mendasarnya, kode Anda tidak boleh membuat asumsi tentang nama mana yang akan dikembalikan metode. Misalnya, enumerasi berikut mendefinisikan dua anggota, Shade.Gray dan Shade.Grey, yang memiliki nilai mendasar yang sama.

enum Shade
{
    White = 0, Gray = 1, Grey = 1, Black = 2
}
type Shade =
    | White = 0
    | Gray = 1
    | Grey = 1
    | Black = 2
Public Enum Shade
   White = 0
   Gray = 1
   Grey = 1
   Black = 2
End Enum

Panggilan metode berikut mencoba mengambil nama anggota Shade enumerasi yang nilai mendasarnya adalah 1. Metode ini dapat mengembalikan "Abu-abu" atau "Abu-abu", dan kode Anda tidak boleh membuat asumsi tentang string mana yang akan dikembalikan.

string shadeName = ((Shade) 1).ToString("F");
let shadeName = (enum<Shade> 1).ToString "F"
Dim shadeName As String = CType(1, Shade).ToString("F")

Lihat juga

Berlaku untuk

ToString(IFormatProvider)

Sumber:
Enum.cs
Sumber:
Enum.cs
Sumber:
Enum.cs

Perhatian

The provider argument is not used. Please use ToString().

Perhatian

The provider argument is not used. Use ToString() instead.

Metode ini kelebihan beban sudah usang; gunakan ToString().

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
[System.Obsolete("The provider argument is not used. Please use ToString().")]
public string ToString (IFormatProvider? provider);
[System.Obsolete("The provider argument is not used. Use ToString() instead.")]
public string ToString (IFormatProvider? provider);
[System.Obsolete("The provider argument is not used. Please use ToString().")]
public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider provider);
[<System.Obsolete("The provider argument is not used. Please use ToString().")>]
override this.ToString : IFormatProvider -> string
[<System.Obsolete("The provider argument is not used. Use ToString() instead.")>]
override this.ToString : IFormatProvider -> string
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parameter

provider
IFormatProvider

(Usang)

Mengembalikan

Representasi string dari nilai instans ini.

Penerapan

Atribut

Berlaku untuk