Enum.ToString Methode

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

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

override this.ToString : string * IFormatProvider -> string

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

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

Parameters

Retouren

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door format.

Implementeringen

Kenmerken

ObsoleteAttribute

Uitzonderingen

Opmerkingen

De format parameter kan een van de volgende notatietekenreeksen zijn: 'G' of 'g', 'D' of 'd', 'X' of 'x' en 'F' of 'f' (de notatietekenreeks is niet hoofdlettergevoelig). Als format dit een lege tekenreeks ("") is null , wordt de algemene notatieaanduiding ('G') gebruikt. Zie Opsomming opmaaktekenreeksen en opmaaktekenreeksen voor meer informatie over de opsommingstekenreeksen en opsommingswaarden. Zie Opmaaktypen voor meer informatie over opmaak in het algemeen.

Geef alleen formatop; de provider parameter is verouderd.

Zie ook

• Format(Type, Object, String)
• Opmaaktypen in .NET
• Opsommingstekenreeksen opmaken

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

public string ToString(string format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Parameters

Retouren

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door format.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u een opgesomde waarde converteert naar een tekenreeks.

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

Opmerkingen

De format parameter kan een van de volgende notatietekenreeksen zijn: 'G' of 'g', 'D' of 'd', 'X' of 'x' en 'F' of 'f' (de notatietekenreeks is niet hoofdlettergevoelig). Als format dit een lege tekenreeks ("") is null , wordt de algemene notatieaanduiding ('G') gebruikt. Zie Opsomming opmaaktekenreeksen en opmaaktekenreeksen voor meer informatie over de opsommingstekenreeksen en opsommingswaarden. Zie Opmaaktypen voor meer informatie over opmaak in het algemeen.

Notities voor bellers

Als meerdere opsommingsleden dezelfde onderliggende waarde hebben en u probeert de tekenreeksweergave van de naam van een opsommingslid op te halen op basis van de onderliggende waarde, mag uw code geen veronderstellingen maken over welke naam de methode retourneert. De volgende opsomming definieert bijvoorbeeld twee leden en Shade.GrayShade.Grey, die dezelfde onderliggende waarde hebben.

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

Met de volgende methode wordt geprobeerd de naam op te halen van een lid van de opsomming waarvan de Shade onderliggende waarde 1 is. De methode kan 'Grijs' of 'Grijs' retourneren en uw code mag geen veronderstellingen maken over welke tekenreeks wordt geretourneerd.

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

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

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

Zie ook

• Format(Type, Object, String)
• Parse(Type, String)
• ToString(String, IFormatProvider)
• Opmaaktypen in .NET
• Opsommingstekenreeksen opmaken

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public string ToString(IFormatProvider provider);

[System.Obsolete("The provider argument is not used. Please use ToString().")]
public string ToString(IFormatProvider provider);

override this.ToString : IFormatProvider -> string

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

Public Function ToString (provider As IFormatProvider) As String

Parameters

Retouren

De tekenreeksweergave van de waarde van dit exemplaar.

Implementeringen

Kenmerken

ObsoleteAttribute

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

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retouren

De tekenreeksweergave van de waarde van dit exemplaar.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een opgesomde waarde converteert naar een tekenreeks.

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

Opmerkingen

De retourwaarde is opgemaakt met de algemene notatieaanduiding ('G'). Als de FlagsAttribute waarde niet wordt toegepast op dit geïnventariseerd type en er een benoemde constante is die gelijk is aan de waarde van dit exemplaar, is de retourwaarde een tekenreeks die de naam van de constante bevat. Als de FlagsAttribute waarde wordt toegepast en er een combinatie is van een of meer benoemde constanten die gelijk zijn aan de waarde van dit exemplaar, is de retourwaarde een tekenreeks met een door scheidingstekens gescheiden lijst met de namen van de constanten. Anders is de retourwaarde de tekenreeksweergave van de numerieke waarde van dit exemplaar. Zie Opsommingstekenreeksen voor meer informatie over het opmaken van opsommingswaarden. Zie Opmaaktypen voor meer informatie over opmaak in het algemeen.

Notities voor bellers

Als meerdere opsommingsleden dezelfde onderliggende waarde hebben en u probeert de tekenreeksweergave van de naam van een opsommingslid op te halen op basis van de onderliggende waarde, mag uw code geen veronderstellingen maken over welke naam de methode retourneert. De volgende opsomming definieert bijvoorbeeld twee leden en Shade.GrayShade.Grey, die dezelfde onderliggende waarde hebben.

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

Met de volgende methode wordt geprobeerd de naam op te halen van een lid van de opsomming waarvan de Shade onderliggende waarde 1 is. De methode kan 'Grijs' of 'Grijs' retourneren en uw code mag geen veronderstellingen maken over welke tekenreeks wordt geretourneerd.

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

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

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

Zie ook

• Format(Type, Object, String)
• Parse(Type, String)