Sabit listesi biçim dizeleriEnumeration format strings

Bir numaralandırma üyesinin sayısal, onaltılı veya dize değerini temsil eden yeni bir String nesnesi oluşturmak için Enum.ToString yöntemini kullanabilirsiniz.You can use the Enum.ToString method to create a new string object that represents the numeric, hexadecimal, or string value of an enumeration member. Bu yöntem, döndürülmek istediğiniz değeri belirtmek için sabit listesi biçimlendirme dizelerinden birini alır.This method takes one of the enumeration formatting strings to specify the value that you want returned.

Aşağıdaki bölümlerde sabit listesi biçimlendirme dizeleri ve döndürdüğü değerler listelenmiştir.The following sections list the enumeration formatting strings and the values they return. Bu biçim belirticileri büyük/küçük harfe duyarlı değildir.These format specifiers are not case-sensitive.

G veya gG or g

Sabit Listesi girişini, mümkünse bir dize değeri olarak görüntüler ve aksi takdirde geçerli örneğin tamsayı değerini görüntüler.Displays the enumeration entry as a string value, if possible, and otherwise displays the integer value of the current instance. Numaralandırma, Flags özniteliği kümesiyle tanımlanmışsa, her bir geçerli girdinin dize değerleri, virgülle ayırarak birlikte birleştirilir.If the enumeration is defined with the Flags attribute set, the string values of each valid entry are concatenated together, separated by commas. Flags özniteliği ayarlanmamışsa, geçersiz bir değer sayısal giriş olarak görüntülenir.If the Flags attribute is not set, an invalid value is displayed as a numeric entry. Aşağıdaki örnekte, G Biçim belirleyicisi gösterilmektedir.The following example illustrates the G format specifier.

Console.WriteLine(ConsoleColor.Red.ToString("G"));         // Displays Red
FileAttributes attributes = FileAttributes.Hidden |
                            FileAttributes.Archive;
Console.WriteLine(attributes.ToString("G"));   // Displays Hidden, Archive                               
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                               

F veya fF or f

Mümkünse, numaralandırma girişini bir dize değeri olarak görüntüler.Displays the enumeration entry as a string value, if possible. Değer, Numaralandırmadaki girişlerin toplamı olarak tamamen görüntülenebilse ( Flags özniteliği mevcut olmasa bile), her bir geçerli girdinin dize değerleri, virgülle ayırarak birlikte birleştirilir.If the value can be completely displayed as a summation of the entries in the enumeration (even if the Flags attribute is not present), the string values of each valid entry are concatenated together, separated by commas. Değer, numaralandırma girişleriyle tamamen tespit edilemez, değer tamsayı değeri olarak biçimlendirilir.If the value cannot be completely determined by the enumeration entries, then the value is formatted as the integer value. Aşağıdaki örnekte, F Biçim belirleyicisi gösterilmektedir.The following example illustrates the F format specifier.

Console.WriteLine(ConsoleColor.Blue.ToString("F"));       // Displays Blue
FileAttributes attributes = FileAttributes.Hidden | 
                            FileAttributes.Archive;
Console.WriteLine(attributes.ToString("F"));   // Displays Hidden, Archive                               
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                               

D veya dD or d

Numaralandırma girişini mümkün olan en kısa temsilde tamsayı değeri olarak görüntüler.Displays the enumeration entry as an integer value in the shortest representation possible. Aşağıdaki örnekte D Biçim belirleyicisi gösterilmektedir.The following example illustrates the D format specifier.

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

X veya xX or x

Sabit Listesi girişini onaltılık bir değer olarak görüntüler.Displays the enumeration entry as a hexadecimal value. Sonuç dizesinin, numaralandırma türünün temel alınan sayısal türündekiher bayt için iki karakteri olduğundan emin olmak için, değer önde gelen sıfır ile temsil edilir.The value is represented with leading zeros as necessary, to ensure that the result string has two characters for each byte in the enumeration type's underlying numeric type. Aşağıdaki örnekte X Biçim belirleyicisi gösterilmektedir.The following example illustrates the X format specifier. Örnekte, hem ConsoleColor hem de FileAttributes temel alınan türü Int32ya da 8 karakterlik bir sonuç dizesi üreten 32 bitlik (veya 4 baytlık) bir tamsayıdır.In the example, the underlying type of both ConsoleColor and FileAttributes is Int32, or a 32-bit (or 4-byte) integer, which produces an 8-character result string.

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

ÖrnekExample

Aşağıdaki örnek üç girdilerden oluşan Colors adlı bir sabit listesi tanımlar: Red, Blueve Green.The following example defines an enumeration called Colors that consists of three entries: Red, Blue, and Green.

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

Sabit Listesi tanımlandıktan sonra bir örnek aşağıdaki şekilde bildirilebilirler.After the enumeration is defined, an instance can be declared in the following manner.

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

Color.ToString(System.String) yöntemi, kendisine geçirilen biçim belirticisine bağlı olarak, numaralandırma değerini farklı yollarla göstermek için kullanılabilir.The Color.ToString(System.String) method can then be used to display the enumeration value in different ways, depending on the format specifier passed to it.

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.      

Ayrıca bkz.See also