Buduj aplikacje przy użyciu bibliotek Microsoft.NETFramework.ReferenceAssemblies

Jeśli docelowa jest określona wersja programu .NET Framework, domyślnie aplikacja jest kompilowana przy użyciu zestawów referencyjnych dołączonych do pakietu deweloperskiego tej wersji. W scenariuszach, w których nie można zainstalować odpowiedniego pakietu deweloperskiego na komputerze, można zamiast tego korzystać z zestawów odwołań dystrybuowanych za pośrednictwem pakietu NuGet.

Aktualizowanie plików projektu

Każdy projekt, który powinien zostać skompilowany na zestawach referencyjnych NuGet, musi zawierać odwołanie do elementu Microsoft.NETFramework.ReferenceAssemblies.

Projekty korzystające z pliku packages.config powinny zawierać następujące elementy w packages.config.

<packages>
  <package id="Microsoft.NETFramework.ReferenceAssemblies" version="1.0.3" developmentDependency="true" />
</packages>

Projekty korzystające z <PackageReference> właściwości MSBuild powinny zawierać następującą właściwość w pliku projektu.

<ItemGroup>
  <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="All" />
</ItemGroup>

Projekty w stylu zestawu SDK domyślnie zawierają to odwołanie. W przypadku typowych projektów programu .NET Framework utworzonych za pomocą programu Visual Studio można dodać odwołanie przy użyciu interfejsu użytkownika Menedżera pakietów NuGet w programie Visual Studio. Pakiet zawiera zestawy referencyjne dla wielu wersji programu .NET Framework. Wersja, która jest rzeczywiście używana, jest określana przez właściwość TargetFrameworkVersion lub TargetFramework, jak już zdefiniowano w pliku projektu.

Przywracanie projektu

Projekty zawierające odwołanie do pakietu muszą zostać przywrócone, aby można je było skompilować.

Po dodaniu pakietu NuGet Microsoft.NETFramework.ReferenceAssemblies do projektu należy jawnie uruchomić akcję przywracania w jeden z następujących sposobów:

• Jeśli projekt jest projektem w stylu innych niż SDK i używa pliku packages.config do odwołowania się do pakietów NuGet:

  1. Zainstaluj narzędzie interfejsu wiersza polecenia NuGet i upewnij się, żenuget.exe znajduje się w zmiennej środowiskowej PATH .
  2. Otwórz wiersz polecenia.
  3. Przejdź do katalogu zawierającego plik projektu.
  4. Uruchom program nuget.exe restore.

• Jeśli projekt jest projektem w stylu innych niż SDK i używa <PackageReference> ustawień w pliku projektu do odwołowania się do pakietów NuGet:

  1. Otwórz Wiersz polecenia dewelopera dla Visual Studio 2022. Nazwa tej aplikacji może się różnić w zależności od zainstalowanej wersji programu Visual Studio.
  2. Przejdź do katalogu zawierającego plik projektu.
  3. Uruchom program msbuild /t:restore.

• Jeśli projekt jest projektem w stylu zestawu SDK, nie musisz nic robić. Akcja przywracania NuGet jest uruchamiana automatycznie podczas budowania projektu.