Share via


Opsommingstekenreeksen

U kunt de Enum.ToString methode gebruiken om een nieuw tekenreeksobject te maken dat de numerieke, hexadecimale waarde of tekenreekswaarde van een opsommingslid vertegenwoordigt. Deze methode gebruikt een van de opsommingstekenreeksen om de waarde op te geven die u wilt retourneren.

De volgende secties bevatten de opsommingsreeksen en de waarden die ze retourneren. Deze notatieaanduidingen zijn niet hoofdlettergevoelig.

G of g

Geeft de opsommingsvermelding weer als een tekenreekswaarde, indien mogelijk, en geeft anders de gehele waarde van het huidige exemplaar weer. Als de opsomming met de FlagsAttribute set is gedefinieerd, worden de tekenreekswaarden van elke geldige vermelding samengevoegd, gescheiden door komma's. Als het Flags kenmerk niet is ingesteld, wordt een ongeldige waarde weergegeven als een numerieke vermelding. In het volgende voorbeeld ziet u de G indelingsaanduiding.

Console.WriteLine(((DayOfWeek)7).ToString("G"));      // 7
Console.WriteLine(ConsoleColor.Red.ToString("G"));    // Red

var attributes = FileAttributes.Hidden | FileAttributes.Archive;
Console.WriteLine(attributes.ToString("G"));          // Hidden, Archive
Console.WriteLine((CType(7, DayOfWeek)).ToString("G"))    ' 7
Console.WriteLine(ConsoleColor.Red.ToString("G"))         ' Red
Dim attributes As FileAttributes = FileAttributes.Hidden Or _
                                   FileAttributes.Archive
Console.WriteLine(attributes.ToString("G"))               ' Hidden, Archive

F of f

Geeft indien mogelijk de opsommingsvermelding weer als een tekenreekswaarde. Als de waarde kan worden weergegeven als een optelsom van de vermeldingen in de opsomming (zelfs als het Flags kenmerk niet aanwezig is), worden de tekenreekswaarden van elke geldige vermelding samengevoegd, gescheiden door komma's. Als de waarde niet kan worden bepaald door de opsommingsvermeldingen, wordt de waarde opgemaakt als de gehele waarde. In het volgende voorbeeld ziet u de F indelingsaanduiding.

Console.WriteLine(((DayOfWeek)7).ToString("F"));       // Monday, Saturday
Console.WriteLine(ConsoleColor.Blue.ToString("F"));    // Blue

var attributes = FileAttributes.Hidden | FileAttributes.Archive;
Console.WriteLine(attributes.ToString("F"));           // Hidden, Archive
Console.WriteLine((CType(7, DayOfWeek)).ToString("F"))    ' Monday, Saturday
Console.WriteLine(ConsoleColor.Blue.ToString("F"))        ' Blue
Dim attributes As FileAttributes = FileAttributes.Hidden Or _
                                   FileAttributes.Archive
Console.WriteLine(attributes.ToString("F"))               ' Hidden, Archive

D of d

Geeft de opsommingsvermelding weer als een geheel getal in de kortst mogelijke weergave. In het volgende voorbeeld ziet u de D indelingsaanduiding.

Console.WriteLine(((DayOfWeek)7).ToString("D"));       // 7
Console.WriteLine(ConsoleColor.Cyan.ToString("D"));    // 11

var attributes = FileAttributes.Hidden | FileAttributes.Archive;
Console.WriteLine(attributes.ToString("D"));           // 34
Console.WriteLine((CType(7, DayOfWeek)).ToString("D"))     ' 7
Console.WriteLine(ConsoleColor.Cyan.ToString("D"))         ' 11
Dim attributes As FileAttributes = FileAttributes.Hidden Or _
                                   FileAttributes.Archive
Console.WriteLine(attributes.ToString("D"))                ' 34

X of x

Geeft de opsommingsvermelding weer als een hexadecimale waarde. De waarde wordt indien nodig weergegeven met voorloopnullen om ervoor te zorgen dat de resultaattekenreeks twee tekens heeft voor elke byte in het onderliggende numerieke type van het opsommingstype. In het volgende voorbeeld ziet u de X-indelingsaanduiding. In het voorbeeld worden de onderliggende typen DayOfWeek, ConsoleColor en FileAttributes dit is Int32, of een 32-bits (of 4-byte) geheel getal, dat een resultaattekenreeks van 8 tekens produceert.

Console.WriteLine(((DayOfWeek)7).ToString("X"));       // 00000007
Console.WriteLine(ConsoleColor.Cyan.ToString("X"));    // 0000000B

var attributes = FileAttributes.Hidden | FileAttributes.Archive;
Console.WriteLine(attributes.ToString("X"));           // 00000022
Console.WriteLine((CType(7, DayOfWeek)).ToString("X"))    ' 00000007
Console.WriteLine(ConsoleColor.Cyan.ToString("X"))        ' 0000000B
Dim attributes As FileAttributes = FileAttributes.Hidden Or _
                                   FileAttributes.Archive
Console.WriteLine(attributes.ToString("X"))               ' 00000022

Opmerking

In het volgende voorbeeld wordt een opsomming gedefinieerd die uit Colors drie vermeldingen bestaat: Red, Blueen Green.

public enum Color { Red = 1, Blue = 2, Green = 3 };
Public Enum Color
    Red = 1
    Blue = 2
    Green = 3
End Enum

Nadat de opsomming is gedefinieerd, kan een exemplaar op de volgende manier worden gedeclareerd.

Color myColor = Color.Green;
Dim myColor As Color = Color.Green

De Color.ToString(System.String) methode kan vervolgens worden gebruikt om de opsommingswaarde op verschillende manieren weer te geven, afhankelijk van de opmaakaanduiding die eraan is doorgegeven.

Console.WriteLine("The value of myColor is {0}.",
                  myColor.ToString("G"));
Console.WriteLine("The value of myColor is {0}.",
                  myColor.ToString("F"));
Console.WriteLine("The value of myColor is {0}.",
                  myColor.ToString("D"));
Console.WriteLine("The value of myColor is 0x{0}.",
                  myColor.ToString("X"));
// The example displays the following output to the console:
//       The value of myColor is Green.
//       The value of myColor is Green.
//       The value of myColor is 3.
//       The value of myColor is 0x00000003.
Console.WriteLine("The value of myColor is {0}.", _
                  myColor.ToString("G"))
Console.WriteLine("The value of myColor is {0}.", _
                  myColor.ToString("F"))
Console.WriteLine("The value of myColor is {0}.", _
                  myColor.ToString("D"))
Console.WriteLine("The value of myColor is 0x{0}.", _
                  myColor.ToString("X"))
' The example displays the following output to the console:
'       The value of myColor is Green.
'       The value of myColor is Green.
'       The value of myColor is 3.
'       The value of myColor is 0x00000003.      

Zie ook