Enum.ToString メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

このインスタンスの値を等価の文字列形式に変換します。

オーバーロード

名前	説明
ToString(String, IFormatProvider)	古い. このメソッドのオーバーロードは古い形式です。ToString(String)を使用します。
ToString()	このインスタンスの値を等価の文字列形式に変換します。
ToString(String)	指定した形式を使用して、このインスタンスの値を等価の文字列形式に変換します。
ToString(IFormatProvider)	古い. このメソッドのオーバーロードは古い形式です。ToString()を使用します。

ToString(String, IFormatProvider)

ソース:

Enum.cs

注意事項

The provider argument is not used. Use ToString(String) instead.

このメソッドのオーバーロードは古い形式です。ToString(String)を使用します。

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

[System.Obsolete("The provider argument is not used. Use ToString(String) instead.")]
public string ToString(string? format, IFormatProvider? provider);

[<System.Obsolete("The provider argument is not used. Use ToString(String) instead.")>]
override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

パラメーター

format

String

形式の指定。

provider

IFormatProvider

(現在は使用されていません。)

返品

String

formatで指定された、このインスタンスの値の文字列形式。

実装

ToString(String, IFormatProvider)

属性

ObsoleteAttribute

例外

FormatException

format には、有効な書式指定が含まれていません。

InvalidOperationException

format は "X" と等しくなりますが、列挙型は不明です。

注釈

format パラメーターには、"G"、"g"、"D"、"d"、"X"、"x"、および "F" または "f" のいずれかの書式指定文字列を指定できます (書式指定文字列では大文字と小文字が区別されません)。 formatがnullまたは空の文字列 ("") の場合は、一般的な書式指定子 ("G") が使用されます。 列挙書式指定文字列と書式設定列挙値の詳細については、「 列挙型書式指定文字列」を参照してください。 書式設定全般の詳細については、「書式設定の種類」 を参照してください。

formatのみを指定します。provider パラメーターは廃止されています。

こちらもご覧ください

• Format(Type, Object, String)
• .NET での型の書式設定
• 列挙型書式指定文字列

ToString()

ソース:

Enum.cs

このインスタンスの値を等価の文字列形式に変換します。

public:
 override System::String ^ ToString();

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

返品

String

このインスタンスの値の文字列表現。

例

次の例では、列挙値を文字列に変換する方法を示します。

using System;

public class EnumSample {
    enum Colors {Red = 1, Blue = 2};

    public static void Main() {
        Enum myColors = Colors.Red;
        Console.WriteLine("The value of this instance is '{0}'",
           myColors.ToString());
    }
}
/*
Output.
The value of this instance is 'Red'.
*/

type Colors =
    | Red = 1
    | Blue = 2

let myColors = Colors.Red
printfn $"The value of this instance is '{myColors.ToString()}'"

// Output.
// The value of this instance is 'Red'.

Public Class EnumSample    
    Enum Colors
        Red = 1
        Blue = 2
    End Enum
    
    Public Shared Sub Main()
        Dim myColors As Colors = Colors.Red
        Console.WriteLine("The value of this instance is '{0}'", _
           myColors.ToString())
    End Sub
End Class

'Output.
'The value of this instance is 'Red'.

注釈

戻り値は、一般的な書式指定子 ("G") で書式設定されます。 つまり、 FlagsAttribute がこの列挙型に適用されておらず、このインスタンスの値と等しい名前付き定数がある場合、戻り値は定数の名前を含む文字列になります。 FlagsAttributeが適用され、このインスタンスの値と等しい 1 つ以上の名前付き定数の組み合わせがある場合、戻り値は定数の名前の区切り記号で区切られたリストを含む文字列になります。 それ以外の場合、戻り値は、このインスタンスの数値の文字列表現です。 列挙値の書式設定の詳細については、「 列挙型書式指定文字列」を参照してください。 書式設定全般の詳細については、「書式設定の種類」 を参照してください。

注意 (呼び出し元)

複数の列挙メンバーが同じ基になる値を持ち、その基になる値に基づいて列挙メンバーの名前の文字列表現を取得しようとする場合、コードはメソッドが返す名前を想定しないようにする必要があります。 たとえば、次の列挙体は、基になる値が同じである 2 つのメンバー ( Shade.Gray と Shade.Grey) を定義します。

enum Shade
{
    White = 0, Gray = 1, Grey = 1, Black = 2
}

type Shade =
    | White = 0
    | Gray = 1
    | Grey = 1
    | Black = 2

Public Enum Shade
   White = 0
   Gray = 1
   Grey = 1
   Black = 2
End Enum

次のメソッド呼び出しは、基になる値が 1 である Shade 列挙体のメンバーの名前を取得しようとします。 このメソッドは "Gray" または "Gray" を返すことができます。コードでは、どの文字列が返されるかを想定しないでください。

string shadeName = ((Shade) 1).ToString();

let shadeName = (enum<Shade> 1).ToString()

Dim shadeName As String = CType(1, Shade).ToString()

こちらもご覧ください

• Format(Type, Object, String)
• Parse(Type, String)

ToString(String)

ソース:

Enum.cs

指定した形式を使用して、このインスタンスの値を等価の文字列形式に変換します。

public:
 System::String ^ ToString(System::String ^ format);

public string ToString(string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

パラメーター

format

String

書式指定文字列。

返品

String

formatで指定された、このインスタンスの値の文字列形式。

例外

FormatException

format に無効な指定が含まれています。

InvalidOperationException

format は "X" と等しくなりますが、列挙型は不明です。

例

次の例では、列挙値を文字列に変換する方法を示します。

// Sample for Enum.ToString(String)
using System;

class Sample
{
    enum Colors {Red, Green, Blue, Yellow = 12};

    public static void Main()
    {
    Colors myColor = Colors.Yellow;

    Console.WriteLine("Colors.Red = {0}", Colors.Red.ToString("d"));
    Console.WriteLine("Colors.Green = {0}", Colors.Green.ToString("d"));
    Console.WriteLine("Colors.Blue = {0}", Colors.Blue.ToString("d"));
    Console.WriteLine("Colors.Yellow = {0}", Colors.Yellow.ToString("d"));

    Console.WriteLine("{0}myColor = Colors.Yellow{0}", Environment.NewLine);

    Console.WriteLine("myColor.ToString(\"g\") = {0}", myColor.ToString("g"));
    Console.WriteLine("myColor.ToString(\"G\") = {0}", myColor.ToString("G"));

    Console.WriteLine("myColor.ToString(\"x\") = {0}", myColor.ToString("x"));
    Console.WriteLine("myColor.ToString(\"X\") = {0}", myColor.ToString("X"));

    Console.WriteLine("myColor.ToString(\"d\") = {0}", myColor.ToString("d"));
    Console.WriteLine("myColor.ToString(\"D\") = {0}", myColor.ToString("D"));

    Console.WriteLine("myColor.ToString(\"f\") = {0}", myColor.ToString("f"));
    Console.WriteLine("myColor.ToString(\"F\") = {0}", myColor.ToString("F"));
    }
}
/*
This example produces the following results:
Colors.Red = 0
Colors.Green = 1
Colors.Blue = 2
Colors.Yellow = 12

myColor = Colors.Yellow

myColor.ToString("g") = Yellow
myColor.ToString("G") = Yellow
myColor.ToString("x") = 0000000C
myColor.ToString("X") = 0000000C
myColor.ToString("d") = 12
myColor.ToString("D") = 12
myColor.ToString("f") = Yellow
myColor.ToString("F") = Yellow
*/

// Sample for Enum.ToString(String)
open System

type Colors =
    | Red = 0 
    | Green = 1 
    | Blue = 2 
    | Yellow = 12

let myColor = Colors.Yellow

printfn $"""Colors.Red = {Colors.Red.ToString "d"}"""
printfn $"""Colors.Green = {Colors.Green.ToString "d"}"""
printfn $"""Colors.Blue = {Colors.Blue.ToString "d"}"""
printfn $"""Colors.Yellow = {Colors.Yellow.ToString "d"}"""

printfn "\nmyColor = Colors.Yellow\n"

printfn $"""myColor.ToString("g") = {myColor.ToString "g"}"""
printfn $"""myColor.ToString("G") = {myColor.ToString "G"}"""

printfn $"""myColor.ToString("x") = {myColor.ToString "x"}"""
printfn $"""myColor.ToString("X") = {myColor.ToString "X"}"""

printfn $"""myColor.ToString("d") = {myColor.ToString "d"}"""
printfn $"""myColor.ToString("D") = {myColor.ToString "d"}"""

printfn $"""myColor.ToString("f") = {myColor.ToString "f"}"""
printfn $"""myColor.ToString("F") = {myColor.ToString "F"}"""

// This example produces the following results:
//     Colors.Red = 0
//     Colors.Green = 1
//     Colors.Blue = 2
//     Colors.Yellow = 12
//    
//     myColor = Colors.Yellow
//    
//     myColor.ToString("g") = Yellow
//     myColor.ToString("G") = Yellow
//     myColor.ToString("x") = 0000000C
//     myColor.ToString("X") = 0000000C
//     myColor.ToString "d" = 12
//     myColor.ToString "d" = 12
//     myColor.ToString("f") = Yellow
//     myColor.ToString("F") = Yellow

' Sample for Enum.ToString(String)
Class Sample
   Enum Colors
      Red
      Green
      Blue
      Yellow = 12
   End Enum 'Colors
   
   Public Shared Sub Main()
      Dim myColor As Colors = Colors.Yellow
      
      Console.WriteLine("Colors.Red = {0}", Colors.Red.ToString("d"))
      Console.WriteLine("Colors.Green = {0}", Colors.Green.ToString("d"))
      Console.WriteLine("Colors.Blue = {0}", Colors.Blue.ToString("d"))
      Console.WriteLine("Colors.Yellow = {0}", Colors.Yellow.ToString("d"))
      
      Console.WriteLine("{0}myColor = Colors.Yellow{0}", Environment.NewLine)
      
      Console.WriteLine("myColor.ToString(""g"") = {0}", myColor.ToString("g"))
      Console.WriteLine("myColor.ToString(""G"") = {0}", myColor.ToString("G"))
      
      Console.WriteLine("myColor.ToString(""x"") = {0}", myColor.ToString("x"))
      Console.WriteLine("myColor.ToString(""X"") = {0}", myColor.ToString("X"))
      
      Console.WriteLine("myColor.ToString(""d"") = {0}", myColor.ToString("d"))
      Console.WriteLine("myColor.ToString(""D"") = {0}", myColor.ToString("D"))
      
      Console.WriteLine("myColor.ToString(""f"") = {0}", myColor.ToString("f"))
      Console.WriteLine("myColor.ToString(""F"") = {0}", myColor.ToString("F"))
   End Sub
End Class
'
'This example produces the following results:
'
'Colors.Red = 0
'Colors.Green = 1
'Colors.Blue = 2
'Colors.Yellow = 12
'
'myColor = Colors.Yellow
'
'myColor.ToString("g") = Yellow
'myColor.ToString("G") = Yellow
'myColor.ToString("x") = 0000000C
'myColor.ToString("X") = 0000000C
'myColor.ToString("d") = 12
'myColor.ToString("D") = 12
'myColor.ToString("f") = Yellow
'myColor.ToString("F") = Yellow
'

注釈

format パラメーターには、"G"、"g"、"D"、"d"、"X"、"x"、および "F" または "f" のいずれかの書式指定文字列を指定できます (書式指定文字列では大文字と小文字が区別されません)。 formatがnullまたは空の文字列 ("") の場合は、一般的な書式指定子 ("G") が使用されます。 列挙書式指定文字列と書式設定列挙値の詳細については、「 列挙型書式指定文字列」を参照してください。 書式設定全般の詳細については、「書式設定の種類」 を参照してください。

注意 (呼び出し元)

複数の列挙メンバーが同じ基になる値を持ち、その基になる値に基づいて列挙メンバーの名前の文字列表現を取得しようとする場合、コードはメソッドが返す名前を想定しないようにする必要があります。 たとえば、次の列挙体は、基になる値が同じである 2 つのメンバー ( Shade.Gray と Shade.Grey) を定義します。

enum Shade
{
    White = 0, Gray = 1, Grey = 1, Black = 2
}

type Shade =
    | White = 0
    | Gray = 1
    | Grey = 1
    | Black = 2

Public Enum Shade
   White = 0
   Gray = 1
   Grey = 1
   Black = 2
End Enum

次のメソッド呼び出しは、基になる値が 1 である Shade 列挙体のメンバーの名前を取得しようとします。 このメソッドは "Gray" または "Gray" を返すことができます。コードでは、どの文字列が返されるかを想定しないでください。

string shadeName = ((Shade) 1).ToString("F");

let shadeName = (enum<Shade> 1).ToString "F"

Dim shadeName As String = CType(1, Shade).ToString("F")

こちらもご覧ください

• Format(Type, Object, String)
• Parse(Type, String)
• ToString(String, IFormatProvider)
• .NET での型の書式設定
• 列挙型書式指定文字列

ToString(IFormatProvider)

ソース:

Enum.cs

注意事項

The provider argument is not used. Use ToString() instead.

このメソッドのオーバーロードは古い形式です。ToString()を使用します。

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

[System.Obsolete("The provider argument is not used. Use ToString() instead.")]
public string ToString(IFormatProvider? provider);

[<System.Obsolete("The provider argument is not used. Use ToString() instead.")>]
override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

パラメーター

provider

IFormatProvider

(廃止)

返品

String

このインスタンスの値の文字列表現。

実装

ToString(IFormatProvider)

属性

ObsoleteAttribute