Compartilhar via


Sequências de Caracteres de Formatação de Enumeração

Você pode usar o método Enum.ToString para criar um novo objeto de sequência de caracteres que representa o valor numérico, hexadecimal, ou valor da sequência de caracteres de um membro de enumeração.Este método usa uma das sequências de caracateres de formatação de enumeração para especificar o valor que você deseja que seja retornado.

A tabela a seguir lista as sequências de caracteres de formatação de enumeração e os valores que elas retornam.Esses especificadores de formato não diferenciam maiúsculas de minúsculas.

Sequência de caracteres de formatação

Resultado

G ou g

Exibe a entrada de enumeração como um valor de sequência de caracteres, se possível; caso contrário, exibe o valor inteiro da instância atual.Se a enumeração for definida com o atributo Flags definido, os valores da sequência de caracteres de cada entrada válida são concatenados, separados por vírgulas.Se o atributo Flags não é definido, um valor inválido é exibido como uma entrada numérica.O exemplo a seguir ilustra o especificador de formato G.

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

F ou f

Exibe a entrada de enumeração como um valor da sequência de caracteres, se possível.Se o valor puder ser totalmente exibido como uma soma das entradas na enumeração (mesmo se o atributo Flags não estiver presente), os valores da sequência de caracteres de cada entrada válida são concatenados, separados por vírgulas.Se o valor não puder ser completamente determinado pelas entradas de enumeração, então o valor é formatado como o valor inteiro.O exemplo a seguir ilustra o especificador de formato F.

Console.WriteLine(ConsoleColor.Blue.ToString("F")) ' Displays Blue
Dim attributes As FileAttributes = FileAttributes.Hidden Or _
FileAttributes.Archive
Console.WriteLine(attributes.ToString("F")) ' Displays Hidden, Archive
Console.WriteLine(ConsoleColor.Blue.ToString("F")); // Displays Blue
FileAttributes attributes = FileAttributes.Hidden |
FileAttributes.Archive;
Console.WriteLine(attributes.ToString("F")); // Displays Hidden, Archive

D ou d

Exibe a entrada de enumeração como um valor inteiro na representação mais curta possível.O exemplo a seguir ilustra o especificador de formato D.

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

X ou x

Exibe a entrada de enumeração como um valor hexadecimal.O valor é representado com zeros à esquerda, conforme necessário, para garantir que o valor tenha no mínimo oito dígitos de tamanho.O exemplo a seguir ilustra o especificador de formato X.

Console.WriteLine(ConsoleColor.Cyan.ToString("X")) ' Displays 0000000B
Dim attributes As FileAttributes = FileAttributes.Hidden Or _
FileAttributes.Archive
Console.WriteLine(attributes.ToString("X")) ' Displays 00000022
Console.WriteLine(ConsoleColor.Cyan.ToString("X")); // Displays 0000000B
FileAttributes attributes = FileAttributes.Hidden |
FileAttributes.Archive;
Console.WriteLine(attributes.ToString("X")); // Displays 00000022

Exemplo

O exemplo a seguir define uma enumeração denominada Colors que consiste em três entradas: Red, Blue, e Green.

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

Após a enumeração estar definida, uma instância pode ser declarada da maneira a seguir.

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

O método Color.ToString(System.String) pode então ser usado para exibir o valor de enumeração de diferentes maneiras, dependendo do especificador de formato passado para ele.

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.      

Consulte também

Outros recursos

Tipos de Formatação