console

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

Console イベント

パブリック イベント

	名前	説明
	CancelKeyPress	Control の修飾子キー (Ctrl) および C コンソール キー (C) が同時に押された場合、つまり、Ctrl キーと C キーが同時に押された場合に発生します。

参照

関連項目

Console クラス
System 名前空間

Console クラス

コンソール アプリケーションの標準入力ストリーム、標準出力ストリーム、および標準エラー ストリームを表します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 Console

Visual Basic (使用法)

静的クラスのメンバは、クラスのインスタンスなしに直接アクセスされます。

C#

public static class Console

C++

public ref class Console abstract sealed

J#

public final class Console

JScript

public final class Console

解説

コンソールは、オペレーティング システムやテキスト ベースのコンソール アプリケーションとのインターフェイスを提供するオペレーティング システムのウィンドウです。ユーザーは、このインターフェイスを介し、コンピュータのキーボードからテキストを入力したり、コンピュータ端末から出力されたテキストを読み取ったりできます。たとえば、Windows のコンソールはコマンド プロンプト ウィンドウと呼ばれ、このウィンドウから、MS-DOS コマンドを実行できます。Console クラスは、コンソールから文字を読み込んだり、コンソールに文字を書き込むアプリケーションに基本サポートを提供します。

コンソールの入出力ストリーム

コンソール アプリケーションを起動すると、3 つの入出力ストリームとコンソールとが、オペレーティング システムによって自動的に関連付けられます。アプリケーションでは、標準入力ストリームからユーザー入力を読み込んだり、通常のデータを標準出力ストリームに書き込んだりできるほか、エラー データを標準エラー出力ストリームに書き込むことができます。これらのストリームは、In、Out、Error の各プロパティの値を通じてアプリケーションに公開されます。

既定では、In プロパティの値は System.IO.TextReader オブジェクトに、また、Out プロパティおよびError プロパティの値は System.IO.TextWriter オブジェクトになります。ただし、これらのプロパティを、コンソール以外のストリーム (ファイル ストリームなど) に関連付けることもできます。これらのストリームを使用した入出力操作は同期されるため、複数のスレッドがストリームからデータを読み込んだり、ストリームに対して書き込みを行ったりすることができます。

Console クラスのメンバは、ストリームの出力先がコンソールに設定されているときには正常に動作するにもかかわらず、ストリームを、たとえばファイルなどにリダイレクトすると例外がスローされる場合があります。標準ストリームをリダイレクトする場合は、System.IO.IOException をキャッチする処理をプログラムに追加してください。

In、Out、Error の各プロパティが表すストリーム オブジェクトのメンバを明示的に呼び出さなければならない場合もあります。たとえば、既定では、WriteLine メソッドは、標準出力ストリームにデータと既定の行終端文字列、つまり復帰とライン フィード ("\r\n") を書き込みます。しかし、Console クラスには、データを標準エラー出力ストリームに書き込むためのメソッドや、ストリームに書き込まれるデータの行終端文字列を変更するためのプロパティがありません。

この問題は、Out プロパティまたは Error プロパティの TextWriter.NewLine プロパティを、別の行終端文字列に設定することで回避できます。たとえば、C# で標準エラー出力ストリームの行終端文字列に、復帰文字とライン フィード文字のシーケンスを 2 つ重ねて使用する場合は、Console.Error.NewLine = "\r\n\r\n"; というステートメントを使用します。その後、エラー出力ストリーム オブジェクトの WriteLine メソッドを、C# ステートメント Console.Error.WriteLine(); で明示的に呼び出すことができます。

画面バッファとコンソール ウィンドウ

コンソールには、画面バッファとコンソール ウィンドウという、密接に関連した 2 つの機能があります。テキストの入出力は、コンソールに割り当てられた画面バッファと呼ばれる領域との間でやり取りされているように見えますが、実際には、コンソールに割り当てられたストリームとの間で行われています。画面バッファはコンソールの属性であり、行と列から成る四角形のグリッドで管理されます。文字は、各グリッドが交差する部分 (文字セル) に格納されます。各文字には前景色が、各文字セルには背景色がそれぞれ割り当てられています。

画面バッファは、コンソール ウィンドウと呼ばれる四角形領域を通じて表示されます。コンソール ウィンドウは、コンソールが持つ、もう一つの属性です。オペレーティング システムのウィンドウであって、コンソールそのものではありません。コンソール ウィンドウもやはり、行と列の並びを持っていますが、そのサイズは画面バッファと同じか、それ以下になります。コンソール ウィンドウを移動することによって、基になる画面バッファのさまざまな領域を表示できます。画面バッファがコンソール ウィンドウよりも大きい場合、画面バッファ領域に対するコンソール ウィンドウの位置関係を変更できるよう、コンソールには自動的にスクロール バーが表示されます。

画面バッファにおける、テキストの現在の読み込み/書き込み位置は、カーソルによって表されます。カーソルは、表示と非表示を切り替えたり、高さを変更したりできます。カーソルが表示されている場合、そのカーソルが常に表示領域内に入るようにコンソール ウィンドウの位置が自動的に移動されます。

画面バッファにおける文字セル座標の原点は左上隅です。また、カーソルとコンソール ウィンドウの位置は、この原点との位置関係で計算されます。位置を指定するには、最上の行は行 0、左端の列は列 0 のように、0 から始まるインデックスを使用します。行と列のインデックスの最大値は Int16.MaxValue になります。

機能

Console クラスには、コンソールから文字を 1 つずつ読み込むメソッドや、行全体を読み込むメソッドのほか、値型、文字配列、オブジェクトのインスタンスを書式付きまたは書式なし文字列に自動的に変換した後、必要に応じて行終端文字列を追加してコンソールに出力する、いくつかの書き込みメソッドがあります。また、Console クラスには、画面バッファ、コンソール ウィンドウ、およびカーソルのサイズを取得/設定する、コンソール ウィンドウおよびカーソルの位置を移動する、画面バッファ内のデータを移動または消去する、前面色および背景色を変更する、コンソールのタイトル バーに表示されるテキストを変更する、ビープ音を出すなど、さまざまなメソッドおよびプロパティがあります。

使用例

標準入力ストリームと標準出力ストリームに対して読み書きを行う方法を次のコード例に示します。これらのストリームは、SetIn メソッドと SetOut メソッドを使用してリダイレクトできます。

Visual Basic

Public Shared Sub Main()
    Console.Write("Hola ")
    Console.WriteLine("Mundo!")
    Console.WriteLine("What is your name: ")
    Dim name As String =
 Console.ReadLine()
    Console.Write("Buenos Dias, ")
    Console.Write(name)
    Console.WriteLine("!")
End Sub 'Main

C#

public static void Main(string[]
 args) {
    Console.Write("Hola ");
    Console.WriteLine("Mundo!");
    Console.WriteLine("What is your name: ");
    String name = Console.ReadLine();
    Console.Write("Buenos Dias, ");
    Console.Write(name);
    Console.WriteLine("!");
}

C++

int main()
{
   Console::Write( L"Hola " );
   Console::WriteLine( L"Mundo!" );
   Console::WriteLine( L"What is your name: " );
   String^ name = Console::ReadLine();
   Console::Write( L"Buenos Dias, " );
   Console::Write( name );
   Console::WriteLine( L"!" );
}

J#

public static void main(String[]
 args)
{
    Console.Write("Hola ");
    Console.WriteLine("Mundo!");
    Console.WriteLine("What is your name: ");
    String name = Console.ReadLine();
    Console.Write("Buenos Dias, ");
    Console.Write(name);
    Console.WriteLine("!");
} //main

JScript

Console.Write("Hola ");
Console.WriteLine("Mundo!");
Console.WriteLine("What is your name: ");
var name : String = Console.ReadLine();
Console.Write("Buenos Dias, ");
Console.Write(name);
Console.WriteLine("!");

継承階層

System.Object
  System.Console

スレッド セーフ

この型は、マルチスレッド操作に対して安全です。

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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

Console プロパティ

パブリック プロパティ

	名前	説明
	BackgroundColor	コンソールの背景色を取得または設定します。
	BufferHeight	バッファ領域の高さを取得または設定します。
	BufferWidth	バッファ領域の幅を取得または設定します。
	CapsLock	CapsLock がオンかオフかを示す値を取得します。
	CursorLeft	バッファ領域におけるカーソルの列位置を取得または設定します。
	CursorSize	文字セル内のカーソルの高さを取得または設定します。
	CursorTop	バッファ領域におけるカーソルの行位置を取得または設定します。
	CursorVisible	カーソルを表示するかどうかを示す値を取得または設定します。
	ForegroundColor	コンソールの前景色を取得または設定します。
	InputEncoding	コンソールが入力内容の読み取り時に使用するエンコーディングを取得または設定します。
	KeyAvailable	キーが押されたかどうか、つまり、押されたキーが入力ストリームに存在するかどうかを示す値を取得します。
	LargestWindowHeight	現在のフォントおよび画面解像度に基づいて、コンソール ウィンドウの最大行数を取得します。
	LargestWindowWidth	現在のフォントおよび画面解像度に基づいて、コンソール ウィンドウの最大列数を取得します。
	NumberLock	NumLock がオンかオフかを示す値を取得します。
	OutputEncoding	コンソールが出力内容の書き込み時に使用するエンコーディングを取得または設定します。
	Title	コンソールのタイトル バーに表示するタイトルを取得または設定します。
	TreatControlCAsInput	Control 修飾子キーと C コンソール キーの組み合わせ (Ctrl + C) を、通常の入力として扱うか、オペレーティング システムにより処理される割り込みとして扱うかを示す値を取得または設定します。
	WindowHeight	コンソール ウィンドウ領域の高さを取得または設定します。
	WindowLeft	コンソール ウィンドウ領域の左端の位置を、画面バッファに対する相対位置として取得または設定します。
	WindowTop	コンソール ウィンドウ領域の上端の位置を、画面バッファに対する相対位置として取得または設定します。
	WindowWidth	コンソール ウィンドウの幅を取得または設定します。

参照

関連項目

Console クラス
System 名前空間

Console メソッド

パブリック メソッド

	名前	説明
	Beep	オーバーロードされます。 コンソールのスピーカーからビープ音を出します。
	Clear	コンソール バッファおよび対応するコンソール ウィンドウをクリアします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	MoveBufferArea	オーバーロードされます。 画面バッファの特定の領域を、指定した領域にコピーします。
	OpenStandardError	オーバーロードされます。 標準エラー ストリームを取得します。
	OpenStandardInput	オーバーロードされます。 標準入力ストリームを取得します。
	OpenStandardOutput	オーバーロードされます。 標準出力ストリームを取得します。
	Read	標準入力ストリームから次の文字を読み取ります。
	ReadKey	オーバーロードされます。 ユーザーによって押された次の文字キーまたはファンクション キーを取得します。
	ReadLine	標準入力ストリームから次の 1 行分の文字を読み取ります。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ResetColor	コンソールの前景色および背景色を既定値に設定します。
	SetBufferSize	画面バッファ領域の高さと幅を指定された値に設定します。
	SetCursorPosition	カーソルの位置を設定します。
	SetError	指定した TextWriter オブジェクトに Error プロパティを設定します。
	SetIn	指定した TextReader オブジェクトに In プロパティを設定します。
	SetOut	指定した TextWriter オブジェクトに Out プロパティを設定します。
	SetWindowPosition	画面バッファに対するコンソール ウィンドウの相対位置を設定します。
	SetWindowSize	コンソール ウィンドウの高さと幅を指定された値に設定します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Write	オーバーロードされます。 指定した値のテキスト形式を標準出力ストリームに書き込みます。
	WriteLine	オーバーロードされます。 指定したデータを標準出力ストリームに書き込み、続けて現在の行終端記号を書き込みます。

参照

関連項目

Console クラス
System 名前空間

Console メンバ

コンソール アプリケーションの標準入力ストリーム、標準出力ストリーム、および標準エラー ストリームを表します。このクラスは継承できません。

Console データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	BackgroundColor	コンソールの背景色を取得または設定します。
	BufferHeight	バッファ領域の高さを取得または設定します。
	BufferWidth	バッファ領域の幅を取得または設定します。
	CapsLock	CapsLock がオンかオフかを示す値を取得します。
	CursorLeft	バッファ領域におけるカーソルの列位置を取得または設定します。
	CursorSize	文字セル内のカーソルの高さを取得または設定します。
	CursorTop	バッファ領域におけるカーソルの行位置を取得または設定します。
	CursorVisible	カーソルを表示するかどうかを示す値を取得または設定します。
	ForegroundColor	コンソールの前景色を取得または設定します。
	InputEncoding	コンソールが入力内容の読み取り時に使用するエンコーディングを取得または設定します。
	KeyAvailable	キーが押されたかどうか、つまり、押されたキーが入力ストリームに存在するかどうかを示す値を取得します。
	LargestWindowHeight	現在のフォントおよび画面解像度に基づいて、コンソール ウィンドウの最大行数を取得します。
	LargestWindowWidth	現在のフォントおよび画面解像度に基づいて、コンソール ウィンドウの最大列数を取得します。
	NumberLock	NumLock がオンかオフかを示す値を取得します。
	OutputEncoding	コンソールが出力内容の書き込み時に使用するエンコーディングを取得または設定します。
	Title	コンソールのタイトル バーに表示するタイトルを取得または設定します。
	TreatControlCAsInput	Control 修飾子キーと C コンソール キーの組み合わせ (Ctrl + C) を、通常の入力として扱うか、オペレーティング システムにより処理される割り込みとして扱うかを示す値を取得または設定します。
	WindowHeight	コンソール ウィンドウ領域の高さを取得または設定します。
	WindowLeft	コンソール ウィンドウ領域の左端の位置を、画面バッファに対する相対位置として取得または設定します。
	WindowTop	コンソール ウィンドウ領域の上端の位置を、画面バッファに対する相対位置として取得または設定します。
	WindowWidth	コンソール ウィンドウの幅を取得または設定します。

パブリック メソッド

	名前	説明
	Beep	オーバーロードされます。 コンソールのスピーカーからビープ音を出します。
	Clear	コンソール バッファおよび対応するコンソール ウィンドウをクリアします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	MoveBufferArea	オーバーロードされます。 画面バッファの特定の領域を、指定した領域にコピーします。
	OpenStandardError	オーバーロードされます。 標準エラー ストリームを取得します。
	OpenStandardInput	オーバーロードされます。 標準入力ストリームを取得します。
	OpenStandardOutput	オーバーロードされます。 標準出力ストリームを取得します。
	Read	標準入力ストリームから次の文字を読み取ります。
	ReadKey	オーバーロードされます。 ユーザーによって押された次の文字キーまたはファンクション キーを取得します。
	ReadLine	標準入力ストリームから次の 1 行分の文字を読み取ります。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ResetColor	コンソールの前景色および背景色を既定値に設定します。
	SetBufferSize	画面バッファ領域の高さと幅を指定された値に設定します。
	SetCursorPosition	カーソルの位置を設定します。
	SetError	指定した TextWriter オブジェクトに Error プロパティを設定します。
	SetIn	指定した TextReader オブジェクトに In プロパティを設定します。
	SetOut	指定した TextWriter オブジェクトに Out プロパティを設定します。
	SetWindowPosition	画面バッファに対するコンソール ウィンドウの相対位置を設定します。
	SetWindowSize	コンソール ウィンドウの高さと幅を指定された値に設定します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Write	オーバーロードされます。 指定した値のテキスト形式を標準出力ストリームに書き込みます。
	WriteLine	オーバーロードされます。 指定したデータを標準出力ストリームに書き込み、続けて現在の行終端記号を書き込みます。

パブリック イベント

	名前	説明
	CancelKeyPress	Control の修飾子キー (Ctrl) および C コンソール キー (C) が同時に押された場合、つまり、Ctrl キーと C キーが同時に押された場合に発生します。

参照

関連項目

Console クラス
System 名前空間