ASP.NET Core 3.0'dan 3.1'e geçiş

  • Makale

Yayınlayan Scott Addie

Bu makalede, mevcut bir ASP.NET Core 3.0 projesinin ASP.NET Core 3.1'e nasıl güncelleştirilecekleri açıklanmaktadır.

Ön koşullar

içinde .NET Core SDK sürümünü güncelleştirme global.json

Belirli bir .NET Core SDK sürümünü hedeflemek için bir global.json dosyaya güveniyorsanız, özelliğini yüklü olan 3.1 SDK sürümüne güncelleştirin version . Örnek:

{
  "sdk": {
-    "version": "3.0.101"
+    "version": "3.1.101"
  }
}

Hedef çerçeveyi güncelleştirme

Proje dosyasında Target Framework Takma Adını (TFM) olarak netcoreapp3.1güncelleştirin:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
-    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

</Project>

Paket başvurularını güncelleştirme

Proje dosyasında, her Microsoft.AspNetCore.* paket başvurusunun Version özniteliğini 3.1.0 veya sonraki bir sürüme güncelleştirin. Örnek:

<ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.0.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.0.0" Condition="'$(Configuration)' == 'Debug'" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.1" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.1.1" Condition="'$(Configuration)' == 'Debug'" />
</ItemGroup>

Docker görüntülerini güncelleştirme

Docker kullanan uygulamalar için ASP.NET Core 3.1 içeren bir temel görüntü kullanın. Örnek:

docker pull mcr.microsoft.com/dotnet/aspnet:3.1

SameSite HTTP cookieiçin öznitelik uygulamaları ASP.NET Core 3.0 ile 3.1 arasında değişti. Gerçekleştirilecek eylemler için aşağıdaki kaynaklara bakın:

Visual Studio ile yayımlama

Dosyada .pubxml 3.1'e güncelleştirin TargetFramework :

- <TargetFramework>netcoreapp3.0</TargetFramework>
+ <TargetFramework>netcoreapp3.1</TargetFramework>

Hataya neden olan değişiklikleri gözden geçirme

Sürüm 3.0'dan 3.1'e geçiş için hataya neden olan değişiklikler bölümünde .NET Core, ASP.NET Core ve Entity Framework Core genelinde 3.0-3.1 arası hataya neden olan değişiklikleri gözden geçirin.

İsteğe bağlı değişiklikler

Aşağıdaki değişiklikler isteğe bağlıdır.

Bileşen Etiketi Yardımcısı'nı kullanma

ASP.NET Core 3.1 bir Component Etiket Yardımcısı tanıtır. Etiket Yardımcısı, projedeki RenderComponentAsync<TComponent>Blazor HTML yardımcı yönteminin yerini alabilir. Örnek:

- @(await Html.RenderComponentAsync<Counter>(RenderMode.ServerPrerendered, new { IncrementAmount = 10 }))
+ <component type="typeof(Counter)" render-mode="ServerPrerendered" param-IncrementAmount="10" />

Daha fazla bilgi için bkz . Prerender ve ASP.NET Core Razor bileşenlerini tümleştirme.

ASP.NET Çekirdek Modülü (ANCM)

Visual Studio yüklenirken ASP.NET Çekirdek Modülü (ANCM) seçili bir bileşen değilse veya sistemde ANCM'nin önceki bir sürümü yüklüyse, en son .NET Core Barındırma Paketi Yükleyicisi'ni (doğrudan indirme) indirin ve yükleyiciyi çalıştırın. Daha fazla bilgi için bkz . Barındırma Paketi.