diff --git a/docs/consume-packages/Package-References-in-Project-Files.md b/docs/consume-packages/Package-References-in-Project-Files.md index c7a6d1eca..6a7718a94 100644 --- a/docs/consume-packages/Package-References-in-Project-Files.md +++ b/docs/consume-packages/Package-References-in-Project-Files.md @@ -3,7 +3,7 @@ title: NuGet PackageReference in project files description: Details on NuGet PackageReference in project files as supported by NuGet 4.0+ and VS2017 and .NET Core 2.0 author: nkolev92 ms.author: nikolev -ms.date: 02/12/2026 +ms.date: 05/19/2026 ms.update-cycle: 1095-days ms.topic: concept-article --- @@ -16,9 +16,15 @@ With PackageReference, you can also use MSBuild conditions to choose package ref ## Project type support -By default, PackageReference is used for .NET projects, .NET Standard projects, and UWP projects targeting Windows 10 Build 15063 (Creators Update) and later, with the exception of C++ UWP projects. .NET Framework projects support PackageReference, but currently default to `packages.config`. To use PackageReference in a .NET Framework project, [migrate](../consume-packages/migrate-packages-config-to-package-reference.md) the dependencies from `packages.config` into your project file, then remove packages.config. +By default, PackageReference is used for .NET projects, .NET Standard projects, and UWP projects targeting Windows 10 Build 15063 (Creators Update) and later. -ASP.NET apps that target the full .NET Framework include only [limited support](https://github.com/NuGet/Home/issues/5877) for PackageReference. C++ and JavaScript project types are unsupported. +.NET Framework projects support PackageReference, but currently default to `packages.config`. +To use PackageReference in a .NET Framework project, [migrate](../consume-packages/migrate-packages-config-to-package-reference.md) the dependencies from `packages.config` into your project file, then remove packages.config. + +C++ PackageReference support is experimental. +For the latest C++ support details, see [NuGet PackageReference for C++ projects in Visual Studio](https://devblogs.microsoft.com/cppblog/nuget-packagereference-for-c-projects-in-visual-studio/). +ASP.NET apps that target the full .NET Framework include only [limited support](https://github.com/NuGet/Home/issues/5877) for PackageReference. +JavaScript project types are unsupported. ## Adding a PackageReference diff --git a/docs/consume-packages/install-use-packages-nuget-cli.md b/docs/consume-packages/install-use-packages-nuget-cli.md index e0fd321c2..a763d9da9 100644 --- a/docs/consume-packages/install-use-packages-nuget-cli.md +++ b/docs/consume-packages/install-use-packages-nuget-cli.md @@ -3,7 +3,7 @@ title: Manage NuGet Packages with the NuGet CLI description: Find out how to use the NuGet CLI, nuget.exe, to manage NuGet packages in non-SDK-style projects that use a packages.config file to list package references. author: mikejo5000 ms.author: mikejo -ms.date: 04/08/2026 +ms.date: 05/19/2026 ms.topic: how-to # customer intent: As a developer, I want to find out how to use the NuGet CLI so that I can manage NuGet packages in my projects and solutions. --- @@ -15,7 +15,10 @@ You can use the `nuget.exe` command-line interface (CLI) to manage NuGet package The NuGet CLI runs on .NET Framework and non-SDK-style projects, for example non-SDK-style projects that target .NET Standard libraries. The NuGet CLI commands can use a project [packages.config](../reference/packages-config.md) file that lists package references. For non-SDK-style projects that use `PackageReference` instead of *packages.config* for package references, use the [dotnet CLI](install-use-packages-dotnet-cli.md) instead. > [!NOTE] -> For most non-SDK-style projects that use *packages.config*, it's best to [migrate packages.config to `PackageReference`](migrate-packages-config-to-package-reference.md), and then use the dotnet CLI instead of the NuGet CLI to manage packages. However, you can't migrate C++ or ASP.NET projects. +> For most non-SDK-style projects that use *packages.config*, it's best to [migrate packages.config to `PackageReference`](migrate-packages-config-to-package-reference.md), and then use the dotnet CLI instead of the NuGet CLI to manage packages. +> However, you can't use the migration tool for C++ or ASP.NET projects. +> C++ PackageReference support is experimental. +> For the latest C++ support details, see [NuGet PackageReference for C++ projects in Visual Studio](https://devblogs.microsoft.com/cppblog/nuget-packagereference-for-c-projects-in-visual-studio/). For most commands, the NuGet CLI tool uses the current folder, unless you specify a different location in the command. To run NuGet CLI commands, open a command-line program and switch to the folder that contains your project file. diff --git a/docs/consume-packages/migrate-packages-config-to-package-reference.md b/docs/consume-packages/migrate-packages-config-to-package-reference.md index 1bb9a436f..279909fd7 100644 --- a/docs/consume-packages/migrate-packages-config-to-package-reference.md +++ b/docs/consume-packages/migrate-packages-config-to-package-reference.md @@ -3,7 +3,7 @@ title: Migrating from packages.config to PackageReference formats description: Details on how to migrate a project from the packages.config management format to PackageReference as supported by NuGet 4.0+ and VS2017 and .NET Core 2.0 author: JonDouglas ms.author: jodou -ms.date: 08/23/2021 +ms.date: 05/19/2026 ms.topic: upgrade-and-migration-article --- @@ -43,7 +43,10 @@ Perform any one of the following NuGet actions: * Run NuGet restore - Right-click on the solution node in the Solution Explorer and select `Restore NuGet Packages` * Build the project which also triggers NuGet restore -You should now be able to see the migration option. Note that this option is not supported and will not show up for ASP.NET and C++ project types. +You should now be able to see the migration option. +Note that this option is not supported and won't show up for ASP.NET and C++ project types. +C++ PackageReference support is experimental. +For the latest C++ support details, see [NuGet PackageReference for C++ projects in Visual Studio](https://devblogs.microsoft.com/cppblog/nuget-packagereference-for-c-projects-in-visual-studio/). ## Migration steps