NuGet パッケージ マネージャー UINuGet Package Manager UI

Windows 上の Visual Studio で NuGet パッケージ マネージャー UI を使用すると、簡単にインストール、アンインストール、およびプロジェクトとソリューションの NuGet パッケージを更新できます。The NuGet Package Manager UI in Visual Studio on Windows allows you to easily install, uninstall, and update NuGet packages in projects and solutions. Visual studio for Mac のエクスペリエンスを参照してください。を含む NuGet パッケージをプロジェクトにします。For the experience in Visual Studio for Mac, see Including a NuGet package in your project. パッケージ マネージャー UI では、Visual Studio のコードに含まれません。The Package Manager UI is not included with Visual Studio Code.

このトピックの内容:In this topic:

注意

Visual Studio 2015 での NuGet パッケージ マネージャーは不足しているが、場合ツール > 拡張機能と更新しています. を検索し、 NuGet パッケージ マネージャー拡張機能。If you're missing the NuGet Package Manager in Visual Studio 2015, check Tools > Extensions and Updates... and search for the NuGet Package Manager extension. Visual Studio の拡張機能インストーラーを使用する場合は、ダウンロード、拡張機能から直接 https://dist.nuget.org/index.htmlします。If you're unable to use the extensions installer in Visual Studio, download the extension directly from https://dist.nuget.org/index.html.

Visual Studio 2017 では、いずれかの NuGet、NuGet パッケージ マネージャーが自動的にインストールします。NET に関連するワークロード。In Visual Studio 2017, NuGet and the NuGet Package Manager are automatically installed with any .NET-related workloads. 個別に選択してインストール、個々 のコンポーネント > コード ツール > NuGet パッケージ マネージャー Visual Studio 2017 インストーラーでオプションです。Install it individually by selecting the Individual components > Code tools > NuGet package manager option in the Visual Studio 2017 installer.

検索して、パッケージをインストールします。Finding and installing a package

  1. ソリューション エクスプ ローラー、いずれかを右クリックして参照プロジェクトや選択NuGet パッケージの管理..In Solution Explorer, right-click either References or a project and select Manage NuGet Packages....

    NuGet パッケージのメニュー オプションを管理します。

  2. 参照 タブには、現在選択されているソースからの人気度でパッケージが表示されます (を参照してくださいパッケージ ソース)。The Browse tab displays packages by popularity from the currently selected source (see package sources). 検索ボックスを使用して、左上の特定のパッケージを検索します。Search for a specific package using the search box on the upper left. パッケージを実現する、その情報を表示するには、一覧から選択、インストールと共にバージョン選択ドロップダウン ボタンをクリックします。Select a package from the list to display its information, which also enables the Install button along with a version-selection drop-down.

    NuGet パッケージのダイアログの参照 タブを管理します。

  3. ドロップダウン リストから目的のバージョンを選択し、選択インストールします。Select the desired version from the drop-down and select Install. Visual Studio では、パッケージとその依存関係をプロジェクトにインストールします。Visual Studio installs the package and its dependencies into the project. ライセンス条項に同意を求められる場合があります。You may be asked to accept license terms. インストールが完了したら、追加されたパッケージが表示されます、インストール済みタブ。パッケージが記載されても、参照のソリューション エクスプ ローラーでプロジェクトに参照できますを示すノードusingステートメント。When installation is complete, the added packages appear on the Installed tab. Packages are also listed in the References node of Solution Explorer, indicating that you can refer to them in the project with using statements.

    ソリューション エクスプ ローラー内の参照

ヒント

プレリリース版を検索に含めるし、プレリリース版で使用できるように、バージョン ドロップダウンの選択、プレリリースを含めるオプション。To include prerelease versions in the search, and to make prerelease versions available in the version drop-down, select the Include prerelease option.

パッケージをアンインストールします。Uninstalling a package

  1. ソリューション エクスプ ローラー、いずれかを右クリックして参照または目的のプロジェクトと選択NuGet パッケージの管理..In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages....

  2. 選択、インストール済みタブ。Select the Installed tab.

  3. (必要な場合は、リストをフィルター処理する検索を使用) をアンインストールするパッケージを選択し、選択アンインストールします。Select the package to uninstall (using search to filter the list if necessary) and select Uninstall.

    パッケージをアンインストールします。

  4. なお、プレリリースを含めるパッケージ ソースコントロールがある影響しないパッケージをアンインストールするときにします。Note that the Include prerelease and Package source controls have no effect when uninstalling packages.

パッケージの更新Updating a package

  1. ソリューション エクスプ ローラー、いずれかを右クリックして参照または目的のプロジェクトと選択NuGet パッケージの管理..(Web サイト プロジェクトを右クリックし、 Binフォルダー)。In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages.... (In web site projects, right-click the Bin folder.)

  2. 選択、更新タブを選択したパッケージ ソースから使用可能な更新プログラムのあるパッケージを参照してください。Select the Updates tab to see packages that have available updates from the selected package sources. 選択プレリリースを含める更新リストにプレリリース パッケージを含めます。Select Include prerelease to include prerelease packages in the update list.

  3. パッケージを更新し、右側のドロップダウン リストから目的のバージョンを選択し、選択選択更新します。Select the package to update, select the desired version from the drop-down on the right, and select Update.

    パッケージの更新

  4. 一部のパッケージ、 Updateボタンが無効になり、参照されている"暗黙的に、SDK によって"というメッセージが表示されます (または"AutoReferenced")。For some packages, the Update button is disabled and a message appears saying that it's "Implicitly referenced by an SDK" (or "AutoReferenced"). このメッセージは、パッケージが大規模なフレームワークまたは SDK の一部であるとは別には更新されないことを示します。This message indicates that the package is part of a larger framework or SDK and should not be updated independently. (このようなパッケージが内部的に付いて<IsImplicitlyDefined>True</IsImplicitlyDefined>)。たとえば、 Microsoft.NETCore.App .NET Core SDK の一部であり、パッケージのバージョンでないアプリケーションで使用されるランタイム フレームワークのバージョンと同じです。(Such packages are internally marked with <IsImplicitlyDefined>True</IsImplicitlyDefined>.) For example, Microsoft.NETCore.App is part of the .NET Core SDK, and the package version is not the same as the version of the runtime framework used by the application. 必要がある、.NET Core のインストールを更新するを新しいバージョンの ASP.NET Core と .NET Core ランタイムを取得します。You need to update your .NET Core installation to get new versions of the ASP.NET Core and .NET Core runtime. .NET Core メタパッケージとバージョン管理の詳細については、このドキュメントを参照してくださいします。See this document for more details on .NET Core metapackages and versioning. これは、次の一般的に使用されるパッケージに適用されます。This applies to the following commonly used packages:

    • Microsoft.AspNetCore.AllMicrosoft.AspNetCore.All
    • Microsoft.AspNetCore.AppMicrosoft.AspNetCore.App
    • Microsoft.NETCore.AppMicrosoft.NETCore.App
    • NETStandard.LibraryNETStandard.Library

    参照または AutoReferenced として暗黙的にマークされているパッケージの例

  5. 最新バージョンに更新プログラムには、複数のパッケージをクリックし、一覧でそれを選択、更新リストの上ボタン。To update multiple packages to their newest versions, select them in the list and select the Update button above the list.

  6. 個々 のパッケージを更新することも、インストール済みタブ。パッケージの詳細がここでは、バージョン セレクターを含める (対象に、プレリリースを含めるオプション)、 Updateボタンをクリックします。You can also update an individual package from the Installed tab. In this case, the details for the package include a version selector (subject to the Include prerelease option) and an Update button.

ソリューションのパッケージを管理します。Managing packages for the solution

ソリューションのパッケージの管理は、複数のプロジェクトを同時に操作する便利な手段です。Managing packages for a solution is a convenient means to work with multiple projects simultaneously.

  1. 選択、ツール > NuGet パッケージ マネージャー > ソリューションの NuGet パッケージを管理しています. メニュー コマンド、またはソリューションを右クリックし NuGet パッケージの管理.:Select the Tools > NuGet Package Manager > Manage NuGet Packages for Solution... menu command, or right-click the solution and select Manage NuGet Packages...:

    ソリューションの NuGet パッケージを管理します。

  2. ソリューションのパッケージを管理する場合、UI を使用して、操作によって影響を受けるプロジェクトを選択できます。When managing packages for the solution, the UI lets you select the projects that are affected by the operations:

    ソリューションのパッケージを管理するときに、プロジェクト セレクター

タブを統合します。Consolidate tab

開発者と同じソリューション内の別のプロジェクト間で同じ NuGet パッケージの異なるバージョンを使用することを不適切な通常見なします。Developers typically consider it bad practice to use different versions of the same NuGet package across different projects in the same solution. パッケージ マネージャー UI は、ソリューションのパッケージを管理することを選択すると、統合を簡単に確認できます個別のバージョン番号を持つパッケージがソリューション内の異なるプロジェクトで使用されているタブ。When you choose to manage packages for a solution, the Package Manager UI provides a Consolidate tab on which you can easily see where packages with distinct version numbers are used by different projects in the solution:

[パッケージ マネージャー UI の統合] タブ

この例で、ClassLibrary1 プロジェクトで使用して EntityFramework 6.2.0、ConsoleApp1 で EntityFramework 6.1.0 を使用している一方です。In this example, the ClassLibrary1 project is using EntityFramework 6.2.0, whereas ConsoleApp1 is using EntityFramework 6.1.0. パッケージのバージョンを統合するには、次の操作を行います。To consolidate package versions, do the following:

  • プロジェクトの一覧で更新するプロジェクトを選択します。Select the projects to update in the project list.
  • これらすべてのプロジェクトで使用するバージョンを選択、バージョンEntityFramework 6.2.0 などのコントロール。Select the version to use in all those projects in the Version control, such as EntityFramework 6.2.0.
  • 選択、インストールボタンをクリックします。Select the Install button.

パッケージ マネージャーは、選択したすべてのプロジェクト、その後、パッケージに表示されなくに選択したパッケージのバージョンをインストール、統合タブ。The Package Manager installs the selected package version into all selected projects, after which the package no longer appears on the Consolidate tab.

パッケージ ソースPackage sources

Visual Studio のパッケージの取得元のソースを変更するには、ソース セレクターから 1 つを選択します。To change the source from which Visual Studio obtains packages, select one from the source selector:

パッケージ マネージャー UI でのパッケージ ソース セレクター

パッケージ ソースを管理するには。To manage package sources:

  1. 選択、設定パッケージ マネージャー UI のアイコンは、以下に示すまたはを使用して、ツール > オプションコマンドをスクロールしてNuGet パッケージ マネージャー:Select the Settings icon in the Package Manager UI outlined below or use the Tools > Options command and scroll to NuGet Package Manager:

    パッケージ マネージャー UI の [設定] アイコン

  2. 選択、パッケージ ソースノード。Select the Package Sources node:

    パッケージのソース オプション

  3. ソースを追加するには、次のように選択します。 +、名前を編集、URL またはパスを入力、ソース制御、および選択Updateします。To add a source, select +, edit the name, enter the URL or path in the Source control, and select Update. ソースは、セレクターのドロップダウン リストに表示されます。The source now appears in the selector drop-down.

  4. パッケージ ソースを変更するには、選択しでの編集を行う、名前ソースボックス、および選択Updateします。To change a package source, select it, make edits in the Name and Source boxes, and select Update.

  5. パッケージ ソースを無効にするには、一覧内の名前の左側にあるボックスをオフにします。To disable a package source, clear the box to the left of the name in the list.

  6. パッケージ ソースを削除することを選択し、、 Xボタンをクリックします。To remove a package source, select it and then select the X button.

  7. 使用し、下矢印ボタンは変わりませんパッケージ ソースの優先順位。Using the up and down arrow buttons does not change the priority order of the package sources. Visual Studio は、パッケージ ソースの順序を無視し、要求に応答する最初のソースからパッケージを使用します。Visual Studio ignores the order of package sources, using the package from whichever source is first to respond to requests. 詳細については、パッケージの復元を参照してください。For more information, see Package restore.

ヒント

コンピューター レベルまたはユーザー レベルで表示する場合がありますパッケージ ソースを削除した後再表示され場合、NuGet.Configファイル。If a package source reappears after deleting it, it may be listed in a computer-level or user-level NuGet.Config files. 参照してくださいNuGet の構成の動作をこれらのファイルの場所、ファイルを手動で編集するかを使用して、ソースを削除、 nuget ソース コマンドします。See Configuring NuGet behavior for the location of these files, then remove the source by editing the files manually or using the nuget sources command.

パッケージ マネージャーのオプションを制御します。Package manager Options control

パッケージ マネージャー UI が、小規模なを表示、パッケージを選択すると、展開可能なオプション(ここで両方とも、折りたたみし、展開) バージョン セレクターで、次のコントロール。When a package is selected, the Package Manager UI displays a small, expandable Options control below the version selector (shown here both collapsed and expanded). 一部のプロジェクトの型だけをプレビュー ウィンドウの表示オプションが提供されます。Note that for some project types, only the Show preview window option is provided.

パッケージ マネージャーのオプション

次のセクションでは、これらのオプションについて説明します。The following sections explain these options.

プレビュー ウィンドウを表示します。Show preview window

選択した場合、モーダル ウィンドウが表示されますが、選択したパッケージの依存関係パッケージをインストールする前に。When selected, a modal window displays which the dependencies of a chosen package before the package is installed:

プレビュー ダイアログ ボックスの例

インストールと更新プログラムのオプションInstall and Update Options

(使用できませんのすべてのプロジェクトの種類。)(Not available for all project types.)

依存関係の動作NuGet がインストールする依存パッケージのバージョンを決定する方法を構成します。Dependency behavior configures how NuGet decides which versions of dependent packages to install:

  • 依存関係を無視するおり、インストールされているパッケージを通常それがすべての依存関係のインストールをスキップします。Ignore dependencies skips installing any dependencies, which typically breaks the package being installed.
  • 最も低い[Default] では、プライマリの選択したパッケージの要件を満たす最低限のバージョン番号と共に、依存関係がインストールされます。Lowest [Default] installs the dependency with the minimal version number that meets the requirements of the primary chosen package.
  • 最上位の修正プログラムでも、同じメジャーおよびマイナー バージョン番号が、パッチ番号の最も高いバージョンをインストールします。Highest Patch installs the version with the same major and minor version numbers, but the highest patch number. たとえば、バージョン 1.2.2 が指定されている場合、最も高いバージョン 1.2 で始まるがインストールされます。For example, if version 1.2.2 is specified then the highest version that starts with 1.2 will be installed
  • 最上位のマイナー同じメジャー バージョン番号が最も高いマイナー番号と修正プログラム番号を使用のバージョンをインストールします。Highest Minor installs the version with the same major version number but the highest minor number and patch number. バージョン 1.2.2 が指定されている場合、最上位のバージョン 1 で始まるはインストールします。If version 1.2.2 is specified, then the highest version that starts with 1 will be installed
  • 最も高い最高の使用可能なバージョンのパッケージをインストールします。Highest installs the highest available version of the package.

競合のアクションをファイルNuGet を使用して、プロジェクトまたはローカル コンピューターに既に存在するパッケージを処理する方法を指定します。File conflict action specifies how NuGet should handle packages that already exist in the project or local machine:

  • プロンプトNuGet 維持するか既存のパッケージを上書きするかどうかを確認するように指示します。Prompt instructs NuGet to ask whether to keep or overwrite existing packages.
  • すべて無視NuGet 既存のパッケージの上書きをスキップするように指示します。Ignore All instructs NuGet to skip overwriting any existing packages.
  • すべて上書きNuGet 既存のパッケージを上書きするように指示します。Overwrite All instructs NuGet to overwrite any existing packages.

アンインストール オプションUninstall Options

(使用できませんのすべてのプロジェクトの種類。)(Not available for all project types.)

依存関係を削除: 選択した場合、プロジェクトの他の場所で参照していない場合、依存パッケージを削除します。Remove dependencies: when selected, removes any dependent packages if they're not referenced elsewhere in the project.

強制アンインストールの依存関係がある場合でも: 選択すると、引き続きプロジェクトで参照されている場合でも、パッケージをアンインストールします。Force uninstall even if there are dependencies on it: when selected, uninstalls a package even if it's still being referenced in the project. これは通常と組み合わせて使用依存関係を削除パッケージをあらゆる要素を削除する依存関係がインストールされていること。This is typically used in combination with Remove dependencies to remove a package and whatever dependencies it installed. このオプションを使用するおそれがあります、ただし、プロジェクトに壊れた参照。Using this option may, however, lead to broken references in the project. このような場合は、する必要がありますこれら他のパッケージを再インストールします。In such cases, you may need to reinstall those other packages.