トレーニング
モジュール
新しい .NET プロジェクトを作成し、パッケージの依存関係を処理する - Training
.NET プロジェクトを作成し、パッケージを追加して、プロジェクト内のパッケージ依存関係を管理する方法を学習します。 .NET Core CLI と NuGet レジストリを使用して、Visual Studio Code でライブラリとツールを C# アプリケーションに追加します。
このブラウザーはサポートされなくなりました。
Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。
ワークロード セット機能は、.NET SDK ワークロードのグループを表すバージョン番号を提供します。 install、update、restore の各コマンドでは、workload-set 更新モードでこの番号を使用して次のメリットを実現します。
workload-set
更新モードでは、そのバージョンを明示的に変更するまで、ワークロードは特定のワークロード セット バージョンにとどまります。ワークロード セットの用途は次のとおりです。
install
コマンドを特定のワークロード セット バージョンに固定する。ワークロード セットを無視して、個々のワークロードの最新バージョンをインストール、更新、または復元することもできます。
8.0.400 SDK では、明示的に選択されている場合にのみ、dotnet workload
コマンドがワークロード セットの更新モードになります。
--version
オプションを指定した dotnet workload install
コマンドでは、指定したワークロード セット バージョンで workload-set
更新モードの install
コマンドを固定します。
このコマンドでは、ルース マニフェストに基づいて最新のワークロードが自動的にインストールされなくなります。
install
コマンドを固定するには:
ワークロード セット バージョンを選択します。 たとえば、9.0.100-preview.7.24414.1
のようにします。
ワークロードを選択します。 たとえば、aspire
のようにします。
dotnet workload install aspire --version 9.0.100-preview.7.24414.1
このコマンドの実行時:
workload-set
更新モードが選択されます。workload-set
更新モードに留まります。maui-ios
など、インストールする別のワークロードを選択します。
dotnet workload install maui-ios
前の install
コマンドの例では、そのワークロード セットがピン留めされているため、このコマンドは、ワークロード セットバージョン9.0.100-preview.7.24414.1
のワークロード バージョンを使用してmaui-ios
ワークロードをインストールします。
--version
を install
または update
と併用すると install
が指定したバージョンに固定されますが、update
は特定のワークロード セット バージョンではなく、workload-set
更新モード用にのみ構成されます。 その後、--version
オプションを指定せずに dotnet workload update
を実行する場合、update
コマンドは以下を実行します。
install
コマンドの固定を解除します。workload-set
更新モードに留まります。インストールされているワークロードを、構成済みのフィードで使用可能な最新のワークロード セット バージョンに更新するには、次のコマンドを実行します。
dotnet workload config --update-mode workload-set
先行のコマンドは、現在マニフェスト更新モードになっている場合にのみ必要です。 不明な場合は、現在の更新モードを確認してください。
dotnet workload update
workload-set
更新モードでは、global.json でワークロード セット バージョンを指定していない限り、このコマンドはワークロードを最新のワークロード セット バージョンに更新します。
global.json で指定しないときに更新するワークロード セット バージョンを指定するには、update
コマンドの --version
オプションを使用します。
ワークロード セット バージョンを選択します。 たとえば、8.0.400
のようにします。
dotnet workload update --version 8.0.400
まだ選択されていない場合は workload-set
更新モードが選択されます。
global.json
ファイルを使用してリポジトリのワークロード セット バージョンを指定するには:
ワークロード セット バージョンを選択します。 たとえば、9.0.100-preview.7.24414.1
のようにします。
次の例のような global.json
ファイルを作成します。
{
"sdk": {
"workloadVersion": "9.0.100-preview.7.24414.1"
}
}
現在のディレクトリが同じリポジトリにあり、CLI が workload-set
更新モードの場合、install
、update
、restore
の各コマンドは、指定されたワークロード セット バージョンのワークロードをインストールします。 global.json ファイルがなく、更新モードを workload-set
している場合、 restore
コマンドは、マニフェストの更新モードから更新モードに切り替えたときに確立されたワークロード セット バージョン workload-set
インストールします。
global.json ファイルにワークロード セット バージョンがある場合、 config
コマンドを実行していない場合や、--version
を使用していない場合でもワークロード コマンドは workload-set
モードになります。 global.json ファイルによってこれらがオーバーライドされます。
その場合に --version
オプションを使用するには、global.json ファイルを含むパスの外側でコマンドを実行します。
global.jsonでワークロード セットのバージョンを指定しない場合は、restore
コマンドで --version
オプションを使用できます。 その場合、restore
コマンドは、ワークロードを指定されたワークロード セット バージョンに復元する前に workload-set
更新モードを選択します。
マニフェスト更新モードでは、 restore
が個々のワークロードの最新バージョンにワークロードをインストールまたは更新します。
現在の更新モードを表示するには、引数を指定せずに --update-mode
オプションで config
コマンドを実行します。 モードは、 workload-set
または manifests
です。 次に例を示します。
dotnet workload config --update-mode
workload-set
現在のワークロード セット バージョンを確認するには、dotnet workload --version
を実行します。 ワークロード セットがインストールされている場合は、9.0.100-preview.7.24414.1 や 8.0.402 などのバージョンが表示されます。 次に例を示します。
dotnet workload --version
9.0.100-preview.7.24414.1
マニフェスト モードの場合、または workload-set
更新モードに切り替えた後にワークロード セット バージョンがまだ確立されていない場合は、<feature band>-manifests.<hash>
の形式でバージョンが表示されます。 次に例を示します。
dotnet workload --version
9.0.100-manifests.cf958b56
ワークロード セットは、パッケージ ID Microsoft.NET.Workloads.<feature band>
の下で、.NET SDK の各リリースで nuget.org に発行されます。 安定したバージョンの SDK には、常に一致するワークロード セット バージョンがあります。 そのため、8.0.400 SDK は 8.0.400 ワークロード セットをインストールでき、401 は 401 セットをインストールできます。 一般に、安定した SDK に対応するワークロード セットをインストールすることをお勧めします。
プレビュー リリースの場合は、パッケージの [README] タブで対応するワークロード セット バージョンを見つけます。たとえば、.NET 9 Preview 7 パッケージの [README] タブを参照してください。
今後、ワークロード セットのバージョンとその内容の一覧を表示できるようになります。
構成されたフィードで使用可能な各ワークロードの最新バージョンをインストールまたは更新するには、ワークロード config
コマンドを実行してマニフェスト更新モードを選択して使用します。
dotnet workload config --update-mode manifests
.NET 8.0.4xx SDK ではマニフェスト モードが既定です。 このバージョンでは、以前に workload-set
更新モードを明示的に選択した場合にのみ、マニフェスト モードを明示的に選択する必要があります。
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。
トレーニング
モジュール
新しい .NET プロジェクトを作成し、パッケージの依存関係を処理する - Training
.NET プロジェクトを作成し、パッケージを追加して、プロジェクト内のパッケージ依存関係を管理する方法を学習します。 .NET Core CLI と NuGet レジストリを使用して、Visual Studio Code でライブラリとツールを C# アプリケーションに追加します。