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

Scott Addie tarafından

Bu makalede mevcut bir ASP.NET Core 3.0 projesini 3.1'e ASP.NET Core açıklanmıştır.

Önkoşullar

güncelleştirme .NET Core SDK sürümünde global.jsgüncelleştirme

Belirli birglobal.js sürümünü hedeflemek için dosyada bir .NET Core SDK bağlıysanız, özelliği yüklü version 3.1 SDK sürümüne güncelleştirin. Örnek:

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

Hedef çerçeveyi güncelleştirme

Proje dosyasında Hedef Çerçeve Bilinen Adını (TFM) olarak güncelleştirin: netcoreapp3.1

<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 paket başvurusu Microsoft.AspNetCore.* özniteliğini Version 3.1.0 veya sonraki bir değere 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, 3.1'ASP.NET Core temel görüntü kullanın. Örnek:

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

React cookie SameSite değişiklikleri

SameSiteHTTP'ler için öznitelik cookie uygulamaları, ASP.NET Core 3.0 ve 3.1 arasında değiştirildi. Alınacak eylemler için aşağıdaki kaynaklara bakın:

• cookieASP.NET Core ' de SameSite s ile çalışma
• aspnet/Duyurular#390
• ASP.NET ve cookie ASP.NET Core'da SameSite ASP.NET Core

Visual Studio ile yayımlama

dosyasında .pubxml dosyasını TargetFramework 3.1'e güncelleştirin:

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

Yeni değişiklikleri gözden geçirme

Sürüm 3.0'dan 3.1'e geçiş için .NET Core, ASP.NET Core ve Entity Framework Core'de 3.0 ile 3.1arasında yeni değişiklikleri gözden geçirme.

İ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ı kullanma

ASP.NET Core 3.1'de bir Component Etiket Yardımcısı tanıtılmaktadır. Etiket Yardımcısı, bir proje RenderComponentAsync<TComponent> içinde HTML yardımcı yönteminin yerini Blazor değiştirebilir. Ö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. ASP.NET Core bileşenlerini önceden ASP.NET Core Razor ve tümleştirin.