演習 - アプリケーションを作成、ビルド、実行する
.NET ソフトウェア開発キット (SDK) には、Visual Studio Code の統合ターミナルからアクセスできるコマンドライン インターフェイス (CLI) が含まれています。 このトレーニングでは、.NET CLI コマンドを使用して、新しいコンソール アプリケーションを作成し、プロジェクト コードをビルドして、アプリケーションを実行します。
たとえば、次の .NET CLI コマンドは、指定したフォルダーの場所に新しいコンソール アプリケーションを作成します。
dotnet new console -o ./CsharpProjects/TestProject
CLI コマンドの構造は、次の 3 つの部分で構成されます。
- ドライバー: この例では
dotnetです。 - コマンド: この例では
new consoleです。 - コマンド引数: この例では
-o ./CsharpProjects/TestProjectです。
注
コマンド引数は、追加情報を提供するために使用できる省略可能なパラメーターです。 前のコマンドは、省略可能なフォルダーの場所を指定せずに実行できます。 たとえば、dotnet new console です。 この場合、新しいコンソール アプリケーションは現在のフォルダーの場所に作成されます。
この演習では、Visual Studio Code を使用して新しいプロジェクト フォルダーを作成し、CLI コマンドを使用して新しいコンソール アプリケーションを作成し、Visual Studio Code エディターでアプリケーションをカスタマイズしてから、アプリをビルドして実行します。
指定したフォルダーに C# コンソール アプリケーションを作成する
まず、見つけやすく再利用しやすいフォルダーの場所にコンソール アプリケーションを作成してください。
Visual Studio Code が開かれていることを確認します。
Windows の [スタート] メニューを使って、Visual Studio Code を見つけて開くことができます。
Visual Studio Code の [ファイル] メニューで、[ フォルダーを開く] を選択します。
[フォルダーを開く] ダイアログが表示されます。 [フォルダーを開く] ダイアログを使用して、C# プロジェクトの新しいフォルダーを作成できます。
注
パーソナル コンピューターで作業していて、コーディング プロジェクトに使用するフォルダーの場所がある場合は、[フォルダーを開く] ダイアログを使用して希望するフォルダーの場所に移動できます。
[ フォルダーを開く] ダイアログで、Windows デスクトップ フォルダーに移動します。
コード プロジェクトを保持するフォルダーの場所が別にある場合は、代わりにそのフォルダーの場所を使用できます。 このトレーニングでは、見つけやすく覚えやすい場所を用意することが重要です。
[ フォルダーを開く ] ダイアログで、[フォルダーの選択] を 選択します。
作成者を信頼するかどうかを確認するセキュリティ ダイアログが表示された場合は、[ はい] を選択します。
Visual Studio Code ターミナル メニューで、[ 新しいターミナル] を選択します。
[ターミナル] パネルのコマンド プロンプトに、現在のフォルダーのフォルダー パスが表示されることに注目してください。 次に例を示します。
C:\Users\someuser\Desktop>ターミナル コマンド プロンプトで、指定したフォルダーに新しいコンソール アプリケーションを作成するには、次のコマンドを入力します。
dotnet new console -o ./CsharpProjects/TestProject
この .NET CLI コマンドでは、.NET プログラム テンプレートを使用して、指定したフォルダーの場所に新しい C# コンソール アプリケーション プロジェクトを作成します。 このコマンドでは、CsharpProjects および TestProject フォルダーが自動的に作成され、
.csprojファイルの名前として TestProject が使用されます。エクスプローラー ビューで、 CsharpProjects フォルダーを 展開します。
[TestProject] フォルダーと、Program.cs という名前の C# プログラム ファイルと、TestProject.csproj という名前の C# プロジェクト ファイルの 2 つが表示されるはずです。 CLI コマンドでは、プロジェクト ファイル (TestProject.csproj) を作成するときにフォルダー名が使われます。 Program.cs ファイルは、C# コードを含むファイルです。
エクスプローラー ビューで、エディター パネルで C# コードを表示するには、 Program.csを選択します。
ご覧のように、既定のコンソール アプリケーションは象徴的な "Hello World!" です。 シングル サインオンを構成します。
// See https://aka.ms/new-console-template for more information Console.WriteLine("Hello, World!");このアプリでは、
Console.WriteLine()メソッドを使って、"Hello World!" をコンソール ウィンドウに表示します。
アプリケーションを更新、ビルド、および実行する
このタスクでは、エクスプローラー ビューを使用してコード プロジェクト フォルダーを開き、"Hello" メッセージをカスタマイズして、アプリケーションを実行します。
Visual Studio Code EXPLORER ビューで、 TestProject フォルダーを右クリックし、[ 統合ターミナルで開く] を選択します。
重要
統合ターミナル パネルのコマンド プロンプトには、コマンドが実行されるフォルダーの場所が表示されます。
buildまたはrunコマンドを実行する前に、ターミナルでプロジェクト フォルダーが開かれていることを確認する必要があります。ターミナル パネルのコマンド プロンプトに次のフォルダー パスが表示されることを確認します。
C:\Users\someuser\Desktop\CsharpProjects\TestProject>Visual Studio Code エディターで、
Console.WriteLine()メソッドを次のように更新してください。Console.WriteLine("Hello C#!");初めて .cs ファイルを編集するときに、Visual Studio Code で、アプリのビルドとデバッグに必要なアセットを追加するようダイアログが表示される場合があります。 プロンプトが表示されたら、[ はい] を選択できます。
[ ファイル ] メニューの [ 保存] を選択します。
コードの変更は、常にファイルに保存する必要があります。 エディターでコードに加えた変更は、コードが保存されるまでコード コンパイラに認識されません。
アプリケーションのビルドをコンパイルするには、ターミナル コマンド プロンプトで次のコマンドを入力してください。
dotnet build
dotnet buildコマンドは、プロジェクトとその依存関係をバイナリ セットにビルドします。 バイナリには、拡張子が* .dll* である中間言語 (IL) ファイルのプロジェクトのコードが含まれます。 プロジェクトの種類と設定に応じて、他のファイルが含まれる場合があります。 興味がある場合は、次のパスのようなフォルダーの場所にあるエクスプローラー ビューで、TestProject.dll ファイルを見つけることができます。C:\Users\someuser\Desktop\CsharpProjects\TestProject\bin\Debug\net7.0\注
フォルダー パスには、ご自分のアカウントと TestProject フォルダーへのフォルダー パスが反映されます。
アプリケーションを実行するには、ターミナル コマンド プロンプトで次のコマンドを入力してください。
dotnet rundotnet runコマンドによって、明示的なコンパイルや起動コマンドなしで、ソース コードが実行されます。 これにより、1 つのコマンドを使用して、ソース コードからアプリケーションを実行する便利なオプションが提供されます。 コマンド ラインからの短期間の反復開発に便利です。 このコマンドは、dotnet ビルド コマンドに依存してコードをビルドします。コマンドの下の行のターミナル パネルに
dotnet runが表示されていることに注意してください。"Hello World!" と表示されている場合は、コードの変更を保存していることを確認します。
これで、Visual Studio Code の設定と、簡単なコード行のビルドと実行が完了しました。