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

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.

Önkoş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 . Örneğin:

{
  "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. Örneğin:

<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. Örneğin:

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

SameSite değişikliklerine tepki verme cookie

SameSite HTTP tanımlama bilgileri iç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:

• ASP.NET Core'da SameSite tanımlama bilgileriyle çalışma
• aspnet/Duyurular#390
• ASP.NET ve ASP.NET Core'da yaklaşan SameSite cookie değişiklikleri

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. Örneğin:

- @(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 Razor bileşenlerini MVC veya Razor Pages ile 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.