Microsoft.NETFramework.ReferenceAssemblies ile uygulama oluşturma

.NET Framework'ün belirli bir sürümünü hedeflediğinizde, uygulamanız varsayılan olarak bu sürümün geliştirici paketine dahil edilen başvuru derlemeleri kullanılarak oluşturulur. Eşleşen geliştirici paketinin bilgisayara yüklenemediği senaryolarda, bunun yerine NuGet paketi aracılığıyla dağıtılan başvuru derlemelerine karşı derleme yapabilirsiniz.

Proje dosyalarını güncelleştirme

NuGet paketinin başvuru derlemelerine göre derlenmesi gereken her projenin Microsoft.NETFramework.ReferenceAssemblies başvurusu içermesi gerekir.

packages.config dosyası kullanan projeler ,packages.configiçinde aşağıdakileri içermelidir.

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

MSBuild özelliğini kullanan <PackageReference> projeler, proje dosyasına aşağıdaki özelliği içermelidir.

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

SDK stilindeki projeler varsayılan olarak bu başvuruya sahiptir. Visual Studio ile oluşturulan tipik .NET Framework projeleri için, Visual Studio'daki NuGet Paket Yöneticisi kullanıcı arabirimini kullanarak başvuruyu ekleyebilirsiniz. Paket, .NET Framework'ün birçok sürümü için başvuru derlemeleri içerir. Aslında kullanılan sürüm, proje dosyasında önceden tanımlandığı gibi TargetFrameworkVersion veya TargetFramework özelliği tarafından belirlenir.

Projeyi geri yükleme

Paket başvurusu içeren projelerin derlenebilmesi için önce geri yüklenmesi gerekir.

Projenize Microsoft.NETFramework.ReferenceAssemblies NuGet paketini ekledikten sonra, geri yükleme eylemini aşağıdaki yollardan biriyle açıkça çalıştırmanız gerekir:

  • Projeniz SDK stilinde olmayan bir projeyse ve NuGet paketlerine başvurmak için packages.config dosyasını kullanıyorsa:

    1. NuGet CLI aracını yükleyin ve nuget.exe ortam değişkeninde PATH olduğundan emin olun.
    2. Komut istemi açın.
    3. Proje dosyanızı içeren dizine gidin.
    4. nuget.exe restore'i çalıştırın.
  • Projeniz SDK stili olmayan bir projeyse ve NuGet paketlerine başvurmak için proje dosyasındaki ayarları kullanıyorsa <PackageReference> :

    1. VS 2022 için Geliştirici Komut İstemi'ni açın. Bu uygulamanın adı, yüklediğiniz Visual Studio sürümüne göre farklı olabilir.
    2. Proje dosyanızı içeren dizine gidin.
    3. msbuild /t:restore'i çalıştırın.
  • Projeniz SDK stilinde bir projeyse hiçbir şey yapmanız gerekmez. Proje oluşturulduğunda NuGet geri yükleme eylemi otomatik olarak çalıştırılır.

Önemli

Başvuru derlemelerinin kullanılması, komut satırından desteklenmeyen .NET Framework sürümlerini hedefleyen projeler derlemeyi mümkün kılar. Ancak, yine de bu projeleri Visual Studio'nun daha yeni sürümlerinde yükleyemezsiniz. Visual Studio'da bu uygulamaları oluşturmaya devam etmek için tek geçici çözüm, Visual Studio'nun eski bir sürümünü kullanmaktır.