チュートリアル: Visual Studio Code を使用して .NET コンソール アプリケーションを作成する

このチュートリアルでは、Visual Studio Code と .NET CLI を使用して NET コンソール アプリケーションを作成して実行する方法を示します。 プロジェクトの作成、コンパイル、実行などのプロジェクト タスクは、.NET CLI を使用して行われます。 必要に応じて、別のコード エディターを使用してこのチュートリアルに従い、ターミナルでコマンドを実行することができます。

必須コンポーネント

• C# 拡張機能がインストールされている Visual Studio Code。 Visual Studio Code に拡張機能をインストールする方法については、VS Code Extension Marketplace を参照してください。
• .NET 7 SDK。

アプリを作成する

"HelloWorld" という名前の .NET コンソール アプリ プロジェクトを作成します。

1. Visual Studio Code を開始します。

2. メイン メニューから [ファイル][フォルダーを開く] (macOS では [ファイル][開く...]) の順に選択します。

3. [フォルダーを開く] ダイアログで、HelloWorld フォルダーを作成して選択します。 次に、 [フォルダーの選択] (macOS の場合は [開く] ) をクリックします。

   フォルダー名は既定でプロジェクト名と名前空間名になります。 このチュートリアルでは後でコードを追加しますが、プロジェクト名前空間は HelloWorld にします。

4. [このフォルダー内のファイルの作成者を信頼しますか] と尋ねるダイアログで、 [はい、作成者を信頼します] を選択します。

5. メイン メニューで [表示][ターミナル] の順に選択して、Visual Studio Code でターミナルを開きます。

   ターミナルが開き、HelloWorld フォルダーにコマンド プロンプトが表示されます。

6. ターミナルで、次のコマンドを入力します。

   dotnet new console --framework net7.0
   

   このテンプレートを使用すると、Console.WriteLine(String) で Console.WriteLine(String) メソッドを呼び出すことによってコンソール ウィンドウに "Hello World" と表示する単純なアプリケーションが作成されます。

   Console.WriteLine("Hello, World!");
   

7. Program.cs の内容を次のコードで置き換えます。

   namespace HelloWorld
   {
       class Program
       {
           static void Main(string[] args)
           {
               Console.WriteLine("Hello World!");
           }
       }
   }
   

   初めて .cs ファイルを編集するときに、Visual Studio Code で、アプリのビルドとデバッグに必要なアセットの追加を求められます。 [はい] を選択すると、Visual Studio Code で launch.json ファイルと tasks.json ファイルを含む .vscode フォルダーが作成されます。

   Note

   プロンプトが表示されない場合、または [はい] を選択せずに誤ってプロンプトを閉じた場合は、次の手順を行って launch.json と tasks.json を作成します。

   • メニューから [実行]>[構成の追加] の順に選択します。
   • [環境の選択] プロンプトで、[.NET 5+ および .NET Core] を選択します。

   コードでは、String 配列を引数として受け取る単一のメソッド Main がある、Program というクラスが定義されます。 Main はアプリケーションのエントリ ポイントで、アプリケーションを起動するときに、ランタイムによって自動的に呼び出されるメソッドです。 アプリケーションが起動されるときに提供されるコマンドライン引数はすべて args 配列にあります。

   最新バージョンの C# では、最上位レベルのステートメントという新しい機能により、 クラスと Main メソッドを省略できます。 既存の C# プログラムの多くは、最上位レベルのステートメントが使用されていないため、このチュートリアルではこの新しい機能を使用していません。 ただし、これは C# 10 で利用可能であり、プログラムで使用するかどうかはスタイルの好みの問題です。

アプリを実行する

ターミナルで次のコマンドを実行します。

dotnet run

プログラムによって "Hello World!" が表示されて終了します。

アプリを拡張する

アプリケーションを拡張し、ユーザーに名前の入力を求め、日付と時刻と共にそれを表示するようにします。

1. Program.cs を開きます。

2. Main の Main メソッドの内容 (Console.WriteLine を呼び出す行) を以下のコードに置き換えます。

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   このコードによりコンソール ウィンドウにプロンプトが表示され、ユーザーが文字列を入力して Enter キーを押すまで待機します。 これはこの文字列を name という変数に格納します。 さらに現在の現地時刻を含む DateTime.Now プロパティの値を取得して、それを currentDate という変数に代入します。 これらの値がコンソール ウィンドウに表示されます。 最後に、コンソール ウィンドウにプロンプトを表示し、Console.ReadKey(Boolean) メソッドを呼び出してユーザーによる入力を待ちます。

   NewLine は、プラットフォームに依存せず、言語に依存せずに、改行を表す方法です。 代替手段は、C# では \n、Visual Basic では vbCrLf です。

   文字列の前にドル記号 ($) を付けると、変数名などの式を文字列で中かっこで囲むことができます。 式の値が、式の代わりに文字列に挿入されます。 この構文は、補間された文字列と呼ばれます。

3. 変更内容を保存します。

   重要

   Visual Studio Code では、変更を明示的に保存する必要があります。 Visual Studio とは異なり、アプリをビルドして実行してもファイルの変更は自動的には保存されません。

4. もう一度プログラムを実行します。

   dotnet run
   

5. プロンプトに対し、名前を入力し、Enter キーを押します。

   

6. 任意のキーを押してプログラムを終了します。

その他の技術情報

• Visual Studio Code の設定

次の手順

このチュートリアルでは、.NET コンソール アプリケーションを作成しました。 次のチュートリアルでは、アプリをデバッグします。

Visual Studio Code を使用して .NET コンソール アプリケーションをデバッグする

このチュートリアルでは、Visual Studio Code と .NET CLI を使用して NET コンソール アプリケーションを作成して実行する方法を示します。 プロジェクトの作成、コンパイル、実行などのプロジェクト タスクは、.NET CLI を使用して行われます。 必要に応じて、別のコード エディターを使用してこのチュートリアルに従い、ターミナルでコマンドを実行することができます。

必須コンポーネント

• C# 拡張機能がインストールされている Visual Studio Code。 Visual Studio Code に拡張機能をインストールする方法については、VS Code Extension Marketplace を参照してください。
• .NET 6 SDK。

アプリを作成する

"HelloWorld" という名前の .NET コンソール アプリ プロジェクトを作成します。

1. Visual Studio Code を開始します。

2. メイン メニューから [ファイル][フォルダーを開く] (macOS では [ファイル][開く...]) の順に選択します。

3. [フォルダーを開く] ダイアログで、HelloWorld フォルダーを作成して選択します。 次に、 [フォルダーの選択] (macOS の場合は [開く] ) をクリックします。

   フォルダー名は既定でプロジェクト名と名前空間名になります。 このチュートリアルでは後でコードを追加しますが、プロジェクト名前空間は HelloWorld にします。

4. [このフォルダー内のファイルの作成者を信頼しますか] と尋ねるダイアログで、 [はい、作成者を信頼します] を選択します。

5. メイン メニューで [表示][ターミナル] の順に選択して、Visual Studio Code でターミナルを開きます。

   ターミナルが開き、HelloWorld フォルダーにコマンド プロンプトが表示されます。

6. ターミナルで、次のコマンドを入力します。

   dotnet new console --framework net6.0 --use-program-main
   

   このテンプレートを使用すると、Console.WriteLine(String) で Console.WriteLine(String) メソッドを呼び出すことによってコンソール ウィンドウに "Hello World" と表示する単純なアプリケーションが作成されます。

   namespace HelloWorld;
   
   class Program
   {
       static void Main(string[] args)
       {
           Console.WriteLine("Hello World!");
       }
   }
   

   初めて .cs ファイルを編集するときに、Visual Studio Code で、アプリのビルドとデバッグに必要なアセットの追加を求められます。 [はい] を選択すると、Visual Studio Code で launch.json ファイルと tasks.json ファイルを含む .vscode フォルダーが作成されます。

   Note

   プロンプトが表示されない場合、または [はい] を選択せずに誤ってプロンプトを閉じた場合は、次の手順を行って launch.json と tasks.json を作成します。

   • メニューから [実行]>[構成の追加] の順に選択します。
   • [環境の選択] プロンプトで、[.NET 5+ および .NET Core] を選択します。

   コードでは、String 配列を引数として受け取る単一のメソッド Main がある、Program というクラスが定義されます。 Main はアプリケーションのエントリ ポイントで、アプリケーションを起動するときに、ランタイムによって自動的に呼び出されるメソッドです。 アプリケーションが起動されるときに提供されるコマンドライン引数はすべて args 配列にあります。

   最新バージョンの C# では、最上位レベルのステートメントという新しい機能により、 クラスと Main メソッドを省略できます。 既存の C# プログラムの多くは、最上位レベルのステートメントが使用されていないため、このチュートリアルではこの新しい機能を使用していません。 ただし、これは C# 10 で利用可能であり、プログラムで使用するかどうかはスタイルの好みの問題です。 プロジェクトの dotnet new 作成に使用したコマンドでは、 オプションを --use-program-main 使用すると、最上位レベルのステートメントが使用されなくなります。

アプリを実行する

ターミナルで次のコマンドを実行します。

dotnet run

プログラムによって "Hello World!" が表示されて終了します。

アプリを拡張する

アプリケーションを拡張し、ユーザーに名前の入力を求め、日付と時刻と共にそれを表示するようにします。

1. Program.cs を開きます。

2. Main の Main メソッドの内容 (Console.WriteLine を呼び出す行) を以下のコードに置き換えます。

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   このコードによりコンソール ウィンドウにプロンプトが表示され、ユーザーが文字列を入力して Enter キーを押すまで待機します。 これはこの文字列を name という変数に格納します。 さらに現在の現地時刻を含む DateTime.Now プロパティの値を取得して、それを currentDate という変数に代入します。 これらの値がコンソール ウィンドウに表示されます。 最後に、コンソール ウィンドウにプロンプトを表示し、Console.ReadKey(Boolean) メソッドを呼び出してユーザーによる入力を待ちます。

   NewLine は、プラットフォームに依存せず、言語に依存せずに、改行を表す方法です。 代替手段は、C# では \n、Visual Basic では vbCrLf です。

   文字列の前にドル記号 ($) を付けると、変数名などの式を文字列で中かっこで囲むことができます。 式の値が、式の代わりに文字列に挿入されます。 この構文は、補間された文字列と呼ばれます。

3. 変更内容を保存します。

   重要

   Visual Studio Code では、変更を明示的に保存する必要があります。 Visual Studio とは異なり、アプリをビルドして実行してもファイルの変更は自動的には保存されません。

4. もう一度プログラムを実行します。

   dotnet run
   

5. プロンプトに対し、名前を入力し、Enter キーを押します。

   

6. 任意のキーを押してプログラムを終了します。

その他の技術情報

• Visual Studio Code の設定

次の手順

このチュートリアルでは、.NET コンソール アプリケーションを作成しました。 次のチュートリアルでは、アプリをデバッグします。

Visual Studio Code を使用して .NET コンソール アプリケーションをデバッグする

このチュートリアルは、.NET 6 と .NET 7 でのみ使用できます。 ページ上部のこれらのオプションのいずれかを選択します。