Console.ForegroundColor プロパティ

.NET Framework クラス ライブラリ リファレンス

Console.ForegroundColor プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

コンソールの前景色を取得または設定します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Property ForegroundColor
 As ConsoleColor

Visual Basic (使用法)

Dim value As ConsoleColor

value = Console.ForegroundColor

Console.ForegroundColor = value

C#

public static ConsoleColor ForegroundColor
 { get; set; }

C++

public:
static property ConsoleColor ForegroundColor {
    ConsoleColor get ();
    void set (ConsoleColor value);
}

J#

/** @property */
public static ConsoleColor get_ForegroundColor
 ()

/** @property */
public static void set_ForegroundColor
 (ConsoleColor value)

JScript

public static function get
 ForegroundColor () : ConsoleColor

public static function set
 ForegroundColor (value : ConsoleColor)

プロパティ値
コンソールの前景色、つまり、表示される各文字の色を指定する ConsoleColor。既定値は灰色です。

例外

例外の種類	条件
ArgumentException	設定操作で指定された色は、System.ConsoleColor の有効なメンバではありません。
SecurityException	ユーザーに、この操作を実行するためのアクセス許可がありません。
IOException	I/O エラーが発生しました。

解説

コンソールを持たない Windows ベース アプリケーションの場合、取得操作で Gray が返されます。

使用例

Console.ForegroundColor プロパティ、Console.BackgroundColor プロパティ、および Console.ResetColor メソッドと組み合わせて、System.ConsoleColor 列挙体を使用するコード例を次に示します。説明する色の効果を確認するには、コンソールでこの例を実行する必要があります。

この例では、Black と White の 2 つの定数のみ明示的に指定され、その他の定数 (Blue、DarkRed など) についてはすべて間接的に指定されています。まず、GetNames メソッドを使用して、定数の名前を取得します。このメソッドは、Enum クラスから継承されます。次に、Enum.Parse メソッドでそれぞれの名前を使用して、対応する列挙型定数を作成します。

Visual Basic

' This example demonstrates the ConsoleColor enumeration.
Imports System

Class Sample
   Public Shared Sub Main()
      Dim nl As [String] = Environment.NewLine
      Dim colorNames As [String]() = ConsoleColor.GetNames(GetType(ConsoleColor))
      Dim x As Integer
      
      ' ---------------------------------------------------------------------------------------
      Console.WriteLine("{0}All the foreground colors on a constant
 black background.", nl)
      Console.WriteLine("  (Black on black is not readable.){0}",
 nl)
      
      For x = 0 To colorNames.Length - 1
         Console.Write("{0,2}: ", x)
         Console.BackgroundColor = ConsoleColor.Black
         Console.ForegroundColor = CType([Enum].Parse(GetType(ConsoleColor),
 _
                                                colorNames(x)), ConsoleColor)
         Console.Write("This is foreground color {0}.",
 colorNames(x))
         Console.ResetColor()
         Console.WriteLine()
      Next x
      ' ---------------------------------------------------------------------------------------
      Console.WriteLine("{0}A constant white foreground on all
 the background colors.", nl)
      Console.WriteLine("  (White on white is not readable.){0}",
 nl)
      
      For x = 0 To colorNames.Length - 1
         Console.Write("{0,2}: ", x)
         Console.ForegroundColor = ConsoleColor.White
         Console.BackgroundColor = CType([Enum].Parse(GetType(ConsoleColor),
 _
                                                colorNames(x)), ConsoleColor)
         Console.Write("This is background color {0}.",
 colorNames(x))
         Console.ResetColor()
         Console.WriteLine()
      Next x
      ' ---------------------------------------------------------------------------------------
   End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'
'All the foreground colors on a constant black background.
'  (Black on black is not readable.)
'
' 0: This is foreground color Black.
' 1: This is foreground color DarkBlue.
' 2: This is foreground color DarkGreen.
' 3: This is foreground color DarkCyan.
' 4: This is foreground color DarkRed.
' 5: This is foreground color DarkMagenta.
' 6: This is foreground color DarkYellow.
' 7: This is foreground color Gray.
' 8: This is foreground color DarkGray.
' 9: This is foreground color Blue.
'10: This is foreground color Green.
'11: This is foreground color Cyan.
'12: This is foreground color Red.
'13: This is foreground color Magenta.
'14: This is foreground color Yellow.
'15: This is foreground color White.
'
'A constant white foreground on all the background colors.
'  (White on white is not readable.)
'
' 0: This is background color Black.
' 1: This is background color DarkBlue.
' 2: This is background color DarkGreen.
' 3: This is background color DarkCyan.
' 4: This is background color DarkRed.
' 5: This is background color DarkMagenta.
' 6: This is background color DarkYellow.
' 7: This is background color Gray.
' 8: This is background color DarkGray.
' 9: This is background color Blue.
'10: This is background color Green.
'11: This is background color Cyan.
'12: This is background color Red.
'13: This is background color Magenta.
'14: This is background color Yellow.
'15: This is background color White.
'

C#

// This example demonstrates the ConsoleColor enumeration.
using System;

class Sample 
{
    public static void Main()
 
    {
    String nl = Environment.NewLine;
    String[] colorNames = ConsoleColor.GetNames(typeof(ConsoleColor));

// ---------------------------------------------------------------------------------------
    Console.WriteLine("{0}All the foreground colors on a constant black background.",
 nl);
    Console.WriteLine("  (Black on black is not readable.){0}", nl);

    for (int x = 0; x < colorNames.Length;
 x++)
    {
    Console.Write("{0,2}: ", x);
    Console.BackgroundColor = ConsoleColor.Black;
    Console.ForegroundColor = (ConsoleColor)Enum.Parse(typeof(ConsoleColor), colorNames[x]);
    Console.Write("This is foreground color {0}.", colorNames[x]);
    Console.ResetColor();
    Console.WriteLine();
    }
// ---------------------------------------------------------------------------------------
    Console.WriteLine("{0}A constant white foreground on all the background
 colors.", nl);
    Console.WriteLine("  (White on white is not readable.){0}", nl);

    for (int x = 0; x < colorNames.Length;
 x++)
    {
    Console.Write("{0,2}: ", x);
    Console.ForegroundColor = ConsoleColor.White;
    Console.BackgroundColor = (ConsoleColor)Enum.Parse(typeof(ConsoleColor), colorNames[x]);
    Console.Write("This is background color {0}.", colorNames[x]);
    Console.ResetColor();
    Console.WriteLine();
    }
// ---------------------------------------------------------------------------------------
    }
}
/*
This example produces the following results:

All the foreground colors on a constant black background.
  (Black on black is not readable.)

 0: This is foreground color Black.
 1: This is foreground color DarkBlue.
 2: This is foreground color DarkGreen.
 3: This is foreground color DarkCyan.
 4: This is foreground color DarkRed.
 5: This is foreground color DarkMagenta.
 6: This is foreground color DarkYellow.
 7: This is foreground color Gray.
 8: This is foreground color DarkGray.
 9: This is foreground color Blue.
10: This is foreground color Green.
11: This is foreground color Cyan.
12: This is foreground color Red.
13: This is foreground color Magenta.
14: This is foreground color Yellow.
15: This is foreground color White.

A constant white foreground on all the background colors.
  (White on white is not readable.)

 0: This is background color Black.
 1: This is background color DarkBlue.
 2: This is background color DarkGreen.
 3: This is background color DarkCyan.
 4: This is background color DarkRed.
 5: This is background color DarkMagenta.
 6: This is background color DarkYellow.
 7: This is background color Gray.
 8: This is background color DarkGray.
 9: This is background color Blue.
10: This is background color Green.
11: This is background color Cyan.
12: This is background color Red.
13: This is background color Magenta.
14: This is background color Yellow.
15: This is background color White.
*/

C++

// This example demonstrates the ConsoleColor enumeration.
using namespace System;
int main()
{
   String^ nl = Environment::NewLine;
   array<String^>^colorNames = Enum::GetNames( ConsoleColor::typeid );

   // ---------------------------------------------------------------------------------------
   Console::WriteLine( "{0}All the foreground colors on a constant black background.",
 nl );
   Console::WriteLine( "  (Black on black is not readable.){0}", nl );
   for ( int x = 0; x < colorNames->Length;
 x++ )
   {
      Console::Write( "{0,2}: ", x );
      Console::BackgroundColor = ConsoleColor::Black;
      Console::ForegroundColor =  *dynamic_cast<ConsoleColor^>(Enum::Parse(
 ConsoleColor::typeid, colorNames[ x ] ));
      Console::Write( "This is foreground color {0}.", colorNames[ x ]
 );
      Console::ResetColor();
      Console::WriteLine();
   }
   Console::WriteLine( "{0}A constant white foreground on all the background
 colors.", nl );
   Console::WriteLine( "  (White on white is not readable.){0}", nl );
   for ( int x = 0; x < colorNames->Length;
 x++ )
   {
      Console::Write( "{0,2}: ", x );
      Console::ForegroundColor = ConsoleColor::White;
      Console::BackgroundColor =  *dynamic_cast<ConsoleColor^>(Enum::Parse(
 ConsoleColor::typeid, colorNames[ x ] ));
      Console::Write( "This is background color {0}.", colorNames[ x ]
 );
      Console::ResetColor();
      Console::WriteLine();

   }
}

/*
This example produces the following results:

All the foreground colors on a constant black background.
(Black on black is not readable.)

0: This is foreground color Black.
1: This is foreground color DarkBlue.
2: This is foreground color DarkGreen.
3: This is foreground color DarkCyan.
4: This is foreground color DarkRed.
5: This is foreground color DarkMagenta.
6: This is foreground color DarkYellow.
7: This is foreground color Gray.
8: This is foreground color DarkGray.
9: This is foreground color Blue.
10: This is foreground color Green.
11: This is foreground color Cyan.
12: This is foreground color Red.
13: This is foreground color Magenta.
14: This is foreground color Yellow.
15: This is foreground color White.

A constant white foreground on all the background colors.
(White on white is not readable.)

0: This is background color Black.
1: This is background color DarkBlue.
2: This is background color DarkGreen.
3: This is background color DarkCyan.
4: This is background color DarkRed.
5: This is background color DarkMagenta.
6: This is background color DarkYellow.
7: This is background color Gray.
8: This is background color DarkGray.
9: This is background color Blue.
10: This is background color Green.
11: This is background color Cyan.
12: This is background color Red.
13: This is background color Magenta.
14: This is background color Yellow.
15: This is background color White.
*/

J#

// This example demonstrates the ConsoleColor enumeration.
import System.*;

class Sample
{
    public static void main(String[]
 args)
    {
        String nl = Environment.get_NewLine();
        String colorNames[] = ConsoleColor.GetNames(ConsoleColor.class.ToType());
        // ----------------------------------------------------------------------
        Console.WriteLine("{0}All the foreground colors on a constant black
 "
            + " background.", nl);
        Console.WriteLine("  (Black on black is not readable.){0}", nl);

        for (int x = 0; x < colorNames.get_Length();
 x++) {
            Console.Write("{0,2}: ", System.Convert.ToString(x));
            Console.set_BackgroundColor(ConsoleColor.Black);
            Console.set_ForegroundColor(((ConsoleColor)(Enum.Parse(
                ConsoleColor.class.ToType(), System.Convert.ToString(
                colorNames.get_Item(x))))));
            Console.Write("This is foreground color {0}.",
                colorNames.get_Item(x));
            Console.ResetColor();
            Console.WriteLine();
        }
        // ----------------------------------------------------------------------
        Console.WriteLine("{0}A constant white foreground on all the "
            + "background colors.", nl);
        Console.WriteLine("  (White on white is not readable.){0}", nl);

        for (int x = 0; x < colorNames.get_Length();
 x++) {
            Console.Write("{0,2}: ", System.Convert.ToString(x));
            Console.set_ForegroundColor(ConsoleColor.White);
            Console.set_BackgroundColor(((ConsoleColor)(Enum.Parse(
                ConsoleColor.class.ToType(), 
                System.Convert.ToString(colorNames.get_Item(x))))));
            Console.Write("This is background color {0}.", 
                colorNames.get_Item(x));
            Console.ResetColor();
            Console.WriteLine();
        }
        // ----------------------------------------------------------------------
    } //main
} //Sample
/*
This example produces the following results:

All the foreground colors on a constant black background.
  (Black on black is not readable.)

 0: This is foreground color Black.
 1: This is foreground color DarkBlue.
 2: This is foreground color DarkGreen.
 3: This is foreground color DarkCyan.
 4: This is foreground color DarkRed.
 5: This is foreground color DarkMagenta.
 6: This is foreground color DarkYellow.
 7: This is foreground color Gray.
 8: This is foreground color DarkGray.
 9: This is foreground color Blue.
10: This is foreground color Green.
11: This is foreground color Cyan.
12: This is foreground color Red.
13: This is foreground color Magenta.
14: This is foreground color Yellow.
15: This is foreground color White.

A constant white foreground on all the background colors.
  (White on white is not readable.)

 0: This is background color Black.
 1: This is background color DarkBlue.
 2: This is background color DarkGreen.
 3: This is background color DarkCyan.
 4: This is background color DarkRed.
 5: This is background color DarkMagenta.
 6: This is background color DarkYellow.
 7: This is background color Gray.
 8: This is background color DarkGray.
 9: This is background color Blue.
10: This is background color Green.
11: This is background color Cyan.
12: This is background color Red.
13: This is background color Magenta.
14: This is background color Yellow.
15: This is background color White.
*/

.NET Framework のセキュリティ

• UIPermission  (セーフ トップレベル ウィンドウおよびサブウィンドウを変更するために必要なアクセス許可)。UIPermissionWindow.SafeTopLevelWindows (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Console クラス
Console メンバ
System 名前空間