Sabit listesi biçim dizeleri

  • Makale

Bir numaralandırma üyesinin Enum.ToString sayısal, onaltılık veya dize değerini temsil eden yeni bir dize nesnesi oluşturmak için yöntemini kullanabilirsiniz. Bu yöntem, döndürülmesini istediğiniz değeri belirtmek için numaralandırma biçimlendirme dizelerinden birini alır.

Aşağıdaki bölümlerde numaralandırma biçimlendirme dizeleri ve döndürdikleri değerler listelemektedir. Bu biçim tanımlayıcıları büyük/küçük harfe duyarlı değildir.

G veya g

Numaralandırma girdisini mümkünse dize değeri olarak görüntüler ve aksi takdirde geçerli örneğin tamsayı değerini görüntüler. Sabit listesi kümeyle FlagsAttribute tanımlanırsa, her geçerli girdinin dize değerleri virgülle ayrılmış olarak birleştirilir. Flags Öznitelik ayarlanmamışsa, sayısal giriş olarak geçersiz bir değer görüntülenir. Aşağıdaki örnekte biçim belirtici gösterilmektedir G .

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 veya f

Mümkünse sabit listesi girdisini dize değeri olarak görüntüler. Değer, numaralandırmadaki girişlerin bir toplamı olarak görüntülenebiliyorsa (öznitelik mevcut olmasa Flags bile), her geçerli girdinin dize değerleri virgülle ayrılmış olarak birleştirilir. Değer numaralandırma girdileri tarafından belirlenemiyorsa, değer tamsayı değeri olarak biçimlendirilir. Aşağıdaki örnekte biçim belirtici gösterilmektedir F .

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 veya d

Numaralandırma girdisini mümkün olan en kısa gösterimde bir tamsayı değeri olarak görüntüler. Aşağıdaki örnekte biçim belirtici gösterilmektedir D .

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 veya x

Numaralandırma girdisini onaltılık değer olarak görüntüler. Sonuç dizesinin, numaralandırma türünün temel alınan sayısal türünde her bayt için iki karakteri olduğundan emin olmak için değer, gerektiğinde baştaki sıfırlarla temsil edilir. Aşağıdaki örnekte X biçim tanımlayıcısı gösterilmektedir. Örnekte, temel alınan ve FileAttributesInt32türleri DayOfWeekConsoleColor veya 8 karakterli sonuç dizesi üreten 32 bit (veya 4 bayt) tamsayıdır.

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

Örnek

Aşağıdaki örnek, adlı Colors üç girdiden oluşan bir numaralandırma tanımlar: Red, Blueve Green.

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

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

Numaralandırma tanımlandıktan sonra bir örnek aşağıdaki şekilde bildirilebilir.

Color myColor = Color.Green;

Dim myColor As Color = Color.Green

Yöntemi Color.ToString(System.String) daha sonra, numaralandırma değerini, ona geçirilen biçim belirticiye bağlı olarak farklı şekillerde görüntülemek için kullanılabilir.

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.