Enum.ToString Yöntem

Başvuru

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bu örneğinin değerini eşdeğer dize gösterimine dönüştürür.

Aşırı Yüklemeler

ToString(String, IFormatProvider)	Geçersiz. Geçersiz. Bu yöntem aşırı yüklemesi kullanımdan kaldırıldı; kullanın ToString(String).
ToString()	Bu örneğinin değerini eşdeğer dize gösterimine dönüştürür.
ToString(String)	Belirtilen biçimi kullanarak bu örneğin değerini eşdeğer dize gösterimine dönüştürür.
ToString(IFormatProvider)	Geçersiz. Geçersiz. Bu yöntem aşırı yüklemesi kullanımdan kaldırıldı; kullanın ToString().

ToString(String, IFormatProvider)

Kaynak:: Enum.cs

Kaynak:: Enum.cs

Kaynak:: Enum.cs

Dikkat

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

Dikkat

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

Bu yöntem aşırı yüklemesi kullanımdan kaldırıldı; kullanın 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

Parametreler

format: String

Biçim belirtimi.

provider: IFormatProvider

(Kullanımdan kaldırıldı.)

Döndürülenler

String

tarafından formatbelirtilen bu örneğin değerinin dize gösterimi.

Uygulamalar

ToString(String, IFormatProvider)

Öznitelikler: ObsoleteAttribute

Özel durumlar

FormatException

format geçerli bir biçim belirtimi içermiyor.

InvalidOperationException

format eşittir "X", ancak numaralandırma türü bilinmiyor.

Açıklamalar

format parametresi şu biçim dizelerinden biri olabilir: "G" veya "g", "D" veya "d", "X" veya "x" ve "F" veya "f" (biçim dizesi büyük/küçük harfe duyarlı değildir). null ise veya boş bir dize ("") iseformat, genel biçim belirtici ("G") kullanılır. Numaralandırma biçim dizeleri ve biçimlendirme sabit listesi değerleri hakkında daha fazla bilgi için bkz. Numaralandırma Biçim Dizeleri. Genel olarak biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

Yalnızca formatbelirtin; provider parametresi kullanımdan kaldırıldı.

Ayrıca bkz.

Şunlara uygulanır

ToString()

Kaynak:: Enum.cs

Kaynak:: Enum.cs

Kaynak:: Enum.cs

Bu örneğinin değerini eşdeğer dize gösterimine dönüştürür.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Döndürülenler

String

Bu örneğin değerinin dize olarak gösterimi.

Örnekler

Aşağıdaki örnekte, numaralandırılmış bir değerin dizeye dönüştürülmesi gösterilmektedir.

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'.

Açıklamalar

Dönüş değeri genel biçim tanımlayıcısı ("G") ile biçimlendirilir. Yani, bu numaralandırılmış türe uygulanmamışsa FlagsAttribute ve bu örneğin değerine eşit adlandırılmış bir sabit varsa, dönüş değeri sabitin adını içeren bir dizedir. FlagsAttribute uygulanırsa ve bu örneğin değerine eşit bir veya daha fazla adlandırılmış sabitin birleşimi varsa, dönüş değeri sabitlerin adlarının sınırlayıcıyla ayrılmış listesini içeren bir dizedir. Aksi takdirde, dönüş değeri bu örneğin sayısal değerinin dize gösterimidir. Numaralandırma değerlerini biçimlendirme hakkında daha fazla bilgi için bkz. Numaralandırma Biçim Dizeleri. Genel olarak biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

Arayanlara Notlar

Birden çok sabit listesi üyesi aynı temel değere sahipse ve bir numaralandırma üyesinin adının dize gösterimini temel aldığı değere göre almaya çalışırsanız, kodunuz yöntemin döndüreceği ad hakkında herhangi bir varsayımda bulunmamalıdır. Örneğin, aşağıdaki numaralandırma aynı temel değere sahip ve Shade.Greyolmak üzere iki üye Shade.Gray tanımlar.

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

Aşağıdaki yöntem çağrısı, temel alınan değeri 1 olan numaralandırma üyesinin Shade adını almayı dener. yöntemi "Gray" veya "Grey" döndürebilir ve kodunuz hangi dizenin döndürüleceği hakkında herhangi bir varsayımda bulunmamalıdır.

string shadeName = ((Shade) 1).ToString();

let shadeName = (enum<Shade> 1).ToString()

Dim shadeName As String = CType(1, Shade).ToString()

Ayrıca bkz.

Şunlara uygulanır

ToString(String)

Kaynak:: Enum.cs

Kaynak:: Enum.cs

Kaynak:: Enum.cs

Belirtilen biçimi kullanarak bu örneğin değerini eşdeğer dize gösterimine dönüştürür.

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

Parametreler

format: String

Biçim dizesi.

Döndürülenler

String

tarafından formatbelirtilen bu örneğin değerinin dize gösterimi.

Özel durumlar

FormatException

format geçersiz bir belirtim içeriyor.

InvalidOperationException

format eşittir "X", ancak numaralandırma türü bilinmiyor.

Örnekler

Aşağıdaki örnekte, numaralandırılmış bir değerin dizeye nasıl dönüştürüldüğü gösterilmektedir.

// 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
'

Açıklamalar

Arayanlara Notlar

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

string shadeName = ((Shade) 1).ToString("F");

let shadeName = (enum<Shade> 1).ToString "F"

Dim shadeName As String = CType(1, Shade).ToString("F")

Ayrıca bkz.

Şunlara uygulanır

ToString(IFormatProvider)

Kaynak:: Enum.cs

Kaynak:: Enum.cs

Kaynak:: Enum.cs

Dikkat

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

Dikkat

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

Bu yöntem aşırı yüklemesi kullanımdan kaldırıldı; kullanın 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

Parametreler

provider: IFormatProvider

(eski)

Döndürülenler

String

Bu örneğin değerinin dize olarak gösterimi.

Uygulamalar

ToString(IFormatProvider)

Öznitelikler: ObsoleteAttribute

Şunlara uygulanır

Aracılığıyla paylaş

Enum.ToString Yöntem

Tanım

Aşırı Yüklemeler

ToString(String, IFormatProvider)

Parametreler

Döndürülenler

Uygulamalar

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

ToString()

Döndürülenler

Örnekler

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

ToString(String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

ToString(IFormatProvider)

Parametreler

Döndürülenler

Uygulamalar

Şunlara uygulanır

Ek kaynaklar