Enum.ToString Metódus

Definíció

Névtér:: System

Szerelvények:: netstandard.dll, System.Runtime.dll

Szerelvény:: System.Runtime.dll

Szerelvény:: mscorlib.dll

Szerelvény:: netstandard.dll

Szerelvények:: mscorlib.dll, System.Runtime.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

A példány értékét a megfelelő sztring-ábrázolásúvá alakítja.

Túlterhelések

Name	Description
ToString(String, IFormatProvider)	Elavult. Elavult. Ez a módszer túlterhelése elavult; használja a ..a0
ToString()	A példány értékét a megfelelő sztring-ábrázolásúvá alakítja.
ToString(String)	Ennek a példánynak az értékét a megadott formátummal egyenértékű sztring-ábrázolássá alakítja.
ToString(IFormatProvider)	Elavult. Elavult. Ez a módszer túlterhelése elavult; használja a ..a0

ToString(String, IFormatProvider)

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Figyelemfelhívás

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

Figyelemfelhívás

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

Ez a módszer túlterhelése elavult; használja a ..a0

public:
 virtual System::String ^ ToString(System::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);

[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. Use ToString(String) instead.")>]
override this.ToString : string * IFormatProvider -> string

[<System.Obsolete("The provider argument is not used. Please use ToString(String).")>]
override this.ToString : string * IFormatProvider -> string

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Paraméterek

format: String

Formátumspecifikáció.

provider: IFormatProvider

(Elavult.)

Válaszok

String

A példány értékének sztringábrázolása a megadott módon format.

Megvalósítás

ToString(String, IFormatProvider)

Attribútumok: ObsoleteAttribute

Kivételek

FormatException

format nem tartalmaz érvényes formátumspecifikációt.

InvalidOperationException

format értéke "X", de az enumerálás típusa ismeretlen.

Megjegyzések

A format paraméter a következő formátumsztringek egyike lehet: "G" vagy "g", "D" vagy "d", "X" vagy "x", "F" vagy "f" (a formátumsztring nem megkülönbözteti a kis- és nagybetűket). Ha format üres null sztring (""), akkor a rendszer az általános formátumjelölőt ("G") használja. A számbavételi formátum sztringjeiről és az enumerálási értékek formázásáról további információt az Enumerálási formázási sztringek című témakörben talál. A formázással kapcsolatos általános információkért lásd a Formázástípusok című témakört.

Adjon meg csak format; a provider paraméter elavult.

Lásd még

A következőre érvényes:

ToString()

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

A példány értékét a megfelelő sztring-ábrázolásúvá alakítja.

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

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Válaszok

String

A példány értékének sztring-ábrázolása.

Példák

Az alábbi példa bemutatja, hogy az enumerált érték sztringgé alakítható.

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

Megjegyzések

A visszatérési érték az általános formátumjelölővel ("G") van formázva. Ez azt jelenti, hogy ha a rendszer nem alkalmazza ezt a FlagsAttribute számbavételi típust, és egy nevesített állandó egyenlő a példány értékével, akkor a visszatérési érték egy sztring, amely az állandó nevét tartalmazza. Ha a rendszer alkalmazza az FlagsAttribute értéket, és egy vagy több elnevezett állandó kombinációja megegyezik a példány értékével, akkor a visszatérési érték egy sztring, amely az állandók neveinek elválasztójelekkel tagolt listáját tartalmazza. Ellenkező esetben a visszatérési érték a példány numerikus értékének sztring-ábrázolása. Az enumerálási értékek formázásával kapcsolatos további információkért lásd: Enumerálási formázási sztringek. A formázással kapcsolatos általános információkért lásd a Formázástípusok című témakört.

Megjegyzések a hívókhoz

Ha több enumerálási tag ugyanazzal az alapul szolgáló értékkel rendelkezik, és megkísérli lekérni az enumerálási tag nevének sztringképét az alapul szolgáló érték alapján, a kód nem feltételezheti, hogy a metódus melyik nevet adja vissza. Az alábbi enumerálás például két tagot határoz meg, Shade.Gray és Shade.Greyugyanazzal a mögöttes értékkel rendelkezik.

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

Az alábbi metódushívás megkísérli lekérni annak az enumerálásnak a Shade nevét, amelynek mögöttes értéke 1. A metódus "Szürke" vagy "Szürke" értéket is visszaadhat, és a kód nem feltételezheti, hogy melyik sztring lesz visszaadva.

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

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

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

Lásd még

A következőre érvényes:

ToString(String)

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Ennek a példánynak az értékét a megadott formátummal egyenértékű sztring-ábrázolássá alakítja.

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

Paraméterek

format: String

Formátumsztring.

Válaszok

String

A példány értékének sztringábrázolása a megadott módon format.

Kivételek

FormatException

format érvénytelen specifikációt tartalmaz.

InvalidOperationException

format értéke "X", de az enumerálás típusa ismeretlen.

Példák

Az alábbi példa bemutatja, hogyan konvertálhat egy számba adott értéket sztringgé.

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

Megjegyzések

Megjegyzések a hívókhoz

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")

Lásd még

A következőre érvényes:

ToString(IFormatProvider)

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Forrás:: Enum.cs

Figyelemfelhívás

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

Figyelemfelhívás

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

Ez a módszer túlterhelése elavult; használja a ..a0

public:
 virtual System::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);

[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. Use ToString() instead.")>]
override this.ToString : IFormatProvider -> string

[<System.Obsolete("The provider argument is not used. Please use ToString().")>]
override this.ToString : IFormatProvider -> string

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Paraméterek

provider: IFormatProvider

(elavult)

Válaszok

String

A példány értékének sztring-ábrázolása.

Megvalósítás

ToString(IFormatProvider)

Attribútumok: ObsoleteAttribute

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?