Sdílet prostřednictvím

Provádění výčtů formátovacích řetězců

  • Článek

Můžete použít metodu Enum.ToString pro vytvoření nového objektu řetězce, který představuje numerické, šestnáctkové nebo řetězcové hodnoty členu výčtu. Tato metoda přebírá jeden z formátovacích řetězců pro výčty pro určení hodnoty, kterou chcete vrátit.

V následující tabulce jsou uvedeny formátovací řetězce pro výčty a vrácené hodnoty. Tyto specifikátory formátu nerozlišují velká a malá písmena.

Řetězec formátu

Výsledek

G nebo g

Zobrazí položku výčtu jako hodnotu řetězce, pokud je to možné a v opačném případě zobrazí celočíselnou hodnotu aktuální instance. Je-li výčet definován se sadou atibutů Flags, řetězcové hodnoty každé platné položky jsou společně zřetězeny a odděleny čárkami. Pokud sada atributů Flags není nastavena, je zobrazena neplatná hodnota jako číselná položka. Následující příklad ukazuje specifikátor formátu G.

F nebo f

Pokud je to možné, zobrazí položku výčtu jako řetězcovou hodnotu. Pokud hodnota může být zcela zobrazena jako souhrn položek ve výčtu (i v případě, že atribut Flags není k dispozici), řetězcové hodnoty každé platné položka jsou spolu zřetězeny a odděleny čárkami. Pokud hodnotu nelze zcela určit podle položek výčtu, hodnota je formátována jako celočíselná hodnota. Následující příklad ukazuje specifikátor formátu F.

D nebo d

Zobrazí položku výčtu jako celočíselnou hodnotu v nejkratší možné reprezentaci. Následující příklad ukazuje specifikátor formátu D.

X nebo x

Zobrazí položky výčtu jako hexadecimální hodnotu. Hodnota je představována podle potřeby s počátečními nulami, aby bylo zajištěno, že hodnota má minimální délku osm číslic. Následující příklad ukazuje specifikátor formátu X.

Příklad

Následující příklad definuje výčet nazvaný Colors, který tvoří tři položky: Red, Blue a Green

Public Enum Color
   Red = 1
   Blue = 2
   Green = 3
End Enum

public enum Color {Red = 1, Blue = 2, Green = 3}

Po definování výčtu mohou být deklarovány instance následujícím způsobem.

Dim myColor As Color = Color.Green      

Color myColor = Color.Green;

Metodu Color.ToString(System.String) lze poté použít pro zobrazení hodnot výčtu různými způsoby v závislosti na předaném specifikátoru formátu.

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.

Viz také

Koncepty

Typy formátování