.NET Core 3.0 Preview 3中关于ASP.NET Core的更新内容
.NET?Core?3.0?Preview?3已經推出，它包含了一系列關于ASP.NET?Core的新的更新。
下面是該預覽版的更新列表：
Razor組件改進:
單項目模板?
新的Razer擴展
Endpoint路由集成
預呈現
Razor類庫中的Razor組件
改進事件處理?
Forms & validation
運行時編譯
Worker服務模板
gRPC模板
Angular模板已更新為Angular 7
SPA認證?
SignalR與Endpoint路由集成
SignalR Java客戶端支持長輪詢
其他詳細信息和已知問題，請參閱發行說明。
要在.NET Core 3.0 Preview 3中開始使用ASP.NET Core，請安裝.NET Core 3.0 Preview 3 SDK
如果您使用的是Visual?Studio，則還需要安裝Visual?Studio?2019的最新預覽版【譯者注：目前VS2019正式版已經發布，直接安裝正式版即可】。
注意：要在Visual?Studio?2019中使用.NET?Core?3.0預覽版，需要啟用選項以使用.NET?Core?SDK預覽版，方法是通過【工具>選項>項目和解決方案> .NET Core>使用.NET Core SDK預覽版】
將現有的ASP.NET?Core應用程序升級到.NET?Core?3.0?Preview?3，請按照ASP.NET?Core文檔中的遷移步驟進行操作。
另請參閱ASP.NET?Core?3.0?中的重大更改的完整列表。
在前面的預覽中，我們介紹了Razor組件，這是一種用ASP.NET核心構建交互式客戶端Web?UI的新方法。本節將會介紹我們在該預覽更新中對Razor組件所做的各種改進。
單項目模板
Razor組件項目模板現在是單個項目，而不是同一解決方案中的兩個項目。所編寫的Razor組件位于托管它們的ASP.NET?Core應用程序中。同一個ASP.NET?Core項目可以包含Razor組件、頁面和視圖。Razor組件模板與其他ASP.NET?Core?Web應用程序模板一樣，默認情況下也啟用了HTTPS。
新的Razer擴展
Razor組件使用Razor語法編寫，但編譯方式與Razor頁面和視圖不同。為了明確哪些Razor文件應該編譯為Razor組件，我們引入了一個新的文件擴展名：.razor。在Razor組件模板中，所有組件文件現在都使用.razor擴展名。Razor頁面和視圖仍然使用.cshtml擴展名。
只要使用_RazorComponentInclude?MSBuild屬性將這些文件標識為Razor組件文件，Razor組件仍然可以使用.cshtml文件擴展名來創建。例如，該版本中的Razor組件模板指定Components文件夾下的所有.cshtml文件為Razor組件。
???1:??<_RazorComponentInclude>Components\**\*.cshtml</_RazorComponentInclude>請注意，這個版本中的.razor文件有很多限制。有關已知問題和可用解決方案的列表，請參考發布說明。
Endpoint路由集成
Razor組件現在已經集成到了ASP.NET?Core中新的Endpoint路由系統。要在應用程序中啟用Razor組件支持，需要在路由配置中使用MapComponentHub<TComponent>。
???1:??app.UseRouting(routes =>???2:??{???3:?? routes.MapRazorPages();???4:?? routes.MapComponentHub<App>("app");這會將應用程序配置以接受交互式Razor組件的傳入連接，并指定根組件App應該在匹配選擇器App的DOM元素中呈現。
預呈現
默認情況下，Razor組件項目模板執行服務端預渲染。也就是說當用戶瀏覽您的應用程序時，服務器將對您的Razor組件執行初始化渲染，并將結果作為純靜態HTML傳遞給瀏覽器。然后，瀏覽器將通過SignalR重新連接到服務器，并將Razor組件切換為完全交互的模式。這兩個階段的交付是有益的，因為：
它提高了站點的感知能力，因為用戶界面可以更快地出現，而無需等待進行任何WebSocket連接，甚至運行任何客戶端腳本。這對連接速度較慢的用戶有著更大的影響，如2G/3G手機。
它可以讓搜索引擎很容易的搜索到你的應用程序。
對于使用更快連接的用戶（如內網用戶），此功能的影響較小，因為無論如何用戶界面都應該立即出現。
設置預渲染，Razor組件項目模板不會有靜態HTML文件。取而代之的是單個Razor頁面/Pages/Index.cshtml，使用Html.RenderComponentAsync<TComponent>()?HTML幫助器預呈現應用程序內容。該頁面還引用components.server.js腳本，在預呈現和下載內容后設置SignalR?連接。由于這是一個Razor頁面，像環境標簽助手這樣的功能就可以工作了。
Index.cshtml
???1:??@page "{*clientPath}"???2:??<!DOCTYPE html>???3:??<html>???4:??<head>???5:?? ...???6:??</head>???7:??<body>???8:?? <app>@(await Html.RenderComponentAsync<App>())</app>???9:?????10:?? <script src="_framework/components.server.js"></script>??11:??</body>??12:??</html>除了應用程序加載速度更快之外，還可以在瀏覽器開發工具中查看下載的HTML源代碼，從而可以看到預渲染正在進行。Razor組件在HTML中是完全呈現的。
Razor類庫中的Razor組件
現在可以將Razor組件添加到Razor類庫中，并使用Razor組件從ASP.NET核心項目引用它們。
在Razer類庫中創建可重用的Razer組件：
1、創建Razer組件應用程序
???1:??dotnet new razorcomponents -o RazorComponentsApp12、創建Razer類庫
???1:??dotnet new razorclasslib -o RazorClassLib13、添加Component1.razor文件到Razer類庫
Component1.razor
???1:??<h1>Component1</h1>???2:??????3:??<p>@message</p>???4:??????5:??@functions {???6:?? string message = "Hello from a Razor Class Library"!;???7:??}1、使用Razor組件從ASP.NET Core應用程序引用Razor類庫
???1:??dotnet add RazorComponentsApp1 reference RazorClassLib1在Razor組件應用程序中，使用@addTagHelper指令從Razor類庫導入所有組件，然后在應用程序中使用component1
Index.razor
???1:??@page "/"???2:??@addTagHelper *, RazorClassLib1???3:??????4:??<h1>Hello,?world!</h1>???5:??????6:??Welcome to your new app.???7:??????8:??<Component1 />注意：在此版本中，Razer類庫與Blazor應用程序并不兼容。另外，Razor類庫還不支持靜態資源。如果要在庫中創建可與Blazor和Razor組件應用程序共享的組件，仍然需要使用Blazor類庫。這寫問題會在未來的更新中解決。
改進事件處理
新的eventcallback和eventcallback<>類型使得定義組件回調更加簡單。例如，考慮以下兩個組件：
MyButton.razor
???1:??<button οnclick="@OnClick">Click?here?and?see?what?happens!</button>???2:??????3:??@functions {???4:?? [Parameter] EventCallback<UIMouseEventArgs> OnClick { get; set; }???5:??}UsesMyButton.razor
???1:??<div>@text</div>???2:??????3:??<MyButton OnClick="ShowMessage" />???4:??????5:??@function {???6:?? string text;???7:??????8:?? void ShowMessage(UIMouseEventArgs e)???9:?? {??10:?? text = "Hello,?world!";??11:?? }??12:??}onclick回調的類型是EventCallback<UIMouseEventArgs>（取代Action<UIMouseEventArgs>），MyButton直接傳遞給onclick事件處理程序。編譯器處理將委托轉換為EventCallback的過程，并將執行其他一些操作，以確保呈現過程具有足夠的信息來呈現正確的目標組件。因此，不需要在ShowMessage事件處理程序中顯式調用StateHasChanged。編譯器處理將委托轉換為EventCallback的過程，并將執行其他一些操作，以確保渲染過程具有足夠的信息來渲染正確的目標組件。因此，不需要在ShowMessage事件處理程序中顯式調用StateHasChanged。
通過使用EventCallback<>類型的OnClick處理程序可以是異步的，而不需要對MyButton進行任何其他代碼的修改。
UsesMyButton.razor
???1:??<div>@text</div>???2:??????3:??<MyButton OnClick="ShowMessageAsync" />???4:??????5:??@function {???6:?? string text;???7:??????8:?? async Task ShowMessageAsync(UIMouseEventArgs e)???9:?? {??10:?? await Task.Yield();??11:?? text = "Hello,?world!";??12:?? }??13:??}我們建議在為事件處理和綁定定義組件參數時使用EventCallback?and?EventCallback<T>。盡可能使用EventCallback<>，因為它是強類型的并且可以向組件的用戶提供更好的反饋。當沒有傳遞給回調函數的值時，也使用EventCallback。
Forms&validation
此預覽版本添加了用于處理表單和驗證的內置組件和基礎結構。
使用.?net進行客戶端web開發的一個好處是能夠在客戶端和服務器之間共享相同的實現邏輯。驗證邏輯是一個很好的邏輯。Razor組件中的新的Forms&validation支持包括使用數據注解處理驗證的支持，或者可以插入你喜歡的驗證系統。
例如，以下Person類型使用數據注解定義驗證邏輯：
???1:??public class Person???2:??{???3:?? [Required(ErrorMessage = "Enter a name")]???4:?? [StringLength(10, ErrorMessage = "That name is too long")]???5:?? public string Name { get; set; }???6:??????7:?? [Range(0, 200, ErrorMessage = "Nobody is that old")]???8:?? public int AgeInYears { get; set; }???9:?????10:?? [Required]??11:?? [Range(typeof(bool), "true", "true", ErrorMessage = "Must accept terms")]??12:?? public bool AcceptsTerms { get; set; }??13:??}以下是如何基于Person模型鎖創建的驗證表單：
???1:??<EditForm Model="@person" OnValidSubmit="@HandleValidSubmit">???2:?? <DataAnnotationsValidator />???3:?? <ValidationSummary />???4:??????5:?? <p class="name">???6:??????????Name:?<InputText?bind-Value="@person.Name" />???7:?? </p>???8:?? <p class="age">???9:??????????Age?(years):?<InputNumber?bind-Value="@person.AgeInYears" />??10:?? </p>??11:?? <p class="accepts-terms">??12:??????????Accepts?terms:?<InputCheckbox?bind-Value="@person.AcceptsTerms" />??13:?? </p>??14:?????15:?? <button type="submit">Submit</button>??16:??</EditForm>??17:?????18:??@functions {??19:?? Person person = new Person();??20:?????21:?? void HandleValidSubmit()??22:?? {??23:?? Console.WriteLine("OnValidSubmit");??24:?? }??25:??}如果將此表單添加到應用程序中，并運行它，你將獲得一個基本表單，該表單在字段更改和表單提交時自動進行字段輸入值的驗證。
這里發生了很多事情，讓我們把它一個一個地分解：
這個表單是使用新的EditForm組件定義的。EditForm將EditContext設置為一個級聯相關的值，該值用于跟蹤關于編輯過程的元數據(例如，已修改的內容、當前驗證消息等)。EditForm還為有效和無效提交(OnValidSubmit、OnInvalidSubmit)提供了合適的事件。如果想自己觸發驗證，也可以直接使用OnSubmit。
DataAnnotationsValidator組件使用數據注解，以驗證支持附加到級聯的EditContext。?使用數據注釋啟用驗證支持需要顯式調用，但我們正在考慮將其作為默認行為，但隨后你可以覆蓋它。
每個表單字段都是使用一組內置的輸入組件（InputText,?InputNumber,?InputCheckbox,?InputSelect等）定義的。這些組件提供默認行為，用于在編輯時驗證并更改它們的CSS類以反映字段狀態。其中一些具有有用的分析邏輯（例如，InputDate和InputNumber將不可解析的值注冊為驗證錯誤，這樣可以優雅地處理它們）。相關字段還支持目標字段的可空性（例如，int？）。
ValidationMessage組件顯示特定字段的驗證消息。
ValidationSummary組件匯總所有驗證消息（類似于驗證摘要標記助手）。
內置的輸入組件存在一些限制，我們希望在將來的更新中改進這些限制。例如，目前不能在生成輸入標記上指定任意屬性。將來，我們計劃啟用組件的所有額外屬性。現在，您需要構建自己的組件子類來處理這些情況。
運行時驗證
對運行時編譯的支持已從.NET?Core?3.0中的ASP.NET核心共享框架中刪除，但現在可以通過向應用程序添加包的方式來啟用它。
啟用運行時編譯：
添加Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation
???1:??<PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.0.0-preview3-19153-02" />在Startup.ConfigureServices添加對AddRazorRuntimeCompilation的調用
???1:??services.AddMvc().AddRazorRuntimeCompilation();Worker服務模板
在preview3中，我們引入了一個名為“Worker?Service”的新模板。此模板被設計為運行長時間運行的后臺進程的起點，就像您可能作為Windows服務或Linux守護進程運行一樣。例如，從消息隊列生成/消費消息，或者監視要處理的文件。它旨在支持ASP.NET?Core的生產力功能，如日志記錄，DI，配置等，而不承載任何Web依賴項。
在接下來的幾天里，我們將發布一些博客文章，提供更多關于使用Worker模板入門的練習。我們將有一些專門官微Windows/SystemD服務發布、在ACI/AKS上運行以及作為WebJob運行的文章。
提醒
雖然其目的是使工作模板默認情況下不依賴于web技術，但在preview3中它仍然使用web?SDK，并在您選擇“ASP.NET?Core?WebApplication”之后顯示出來。
Angular模板更新到了Angular 7
Angular模板更新到了Angular?7。在?.NET?Core?3.0?發布穩定版本之前，我們預計會更新到Angular?8。
SPA身份認證
這個版本，在Angular和React模板中引入了對身份驗證的支持。在本節中，我們將展示如何創建一個新的Angular或React模板，該模板允許我們對用戶進行身份驗證并訪問受保護的API資源。
我們對用戶身份驗證和授權的支持是由IdentityServer在后臺提供的，我們構建了一些擴展來簡化我們特定場景的配置體驗。
注意：在本文中，我們展示了對Angular的身份驗證支持，但在React模板中提供了相同的功能。
創建新的Angular應用程序
要創建一一個新的支持身份驗證的Angular應用程序，我們需要調用以下命令:
???1:??dotnet new angular -au Individual這個命令創建一個新的ASP.NET?Core應用程序和托管的客戶端Angular應用程序。ASP.NET?Core應用程序包括已配置的Identity?Server實例，可是讓Angular應用程序很方面的對用戶進行身份驗證，并針對ASP.NET?Core應用程序中的受保護資源發送HTTP請求。
Angular模塊所構建的身份驗證和授權支持，可以導入到您的應用程序中，并提供一套組件和服務來增強主應用程序模塊的功能。
運行該應用程序
要運行應用程序，只需執行以下命令，然后用瀏覽器打開控制臺上顯示的URL：
???1:??dotnet run???1:??Hosting?environment:?Development???2:??Content?root?path:?C:\angularapp???3:??Now?listening?on:?https://localhost:5001???4:??Now?listening?on:?http://localhost:5000???5:??Application started. Press Ctrl+C to shut down.運行結果如下：
當我們打開應用程序時，我們會看到常用的Home、Counter和Fetch數據菜單選項以及兩個新選項:Register和Login。如果單擊Register，我們將被發送到默認的認證界面(在運行遷移和更新數據庫之后)，在那里我們可以注冊為新用戶。
注冊為新用戶后，我們將被重定向回應用程序，在那里我們可以看到我們成功地通過了身份驗證。
調用經過身份驗證的API
如果我們點擊獲取數據，我們可以看到天氣預報數據列表
保護現有的API
要保護服務器上的API，只需要在要保護的控制器或操作上使用[Authorize]屬性。
???1:??[Authorize]???2:??[Route("api/[controller]")]???3:??public class?SampleDataController?:?Controller???4:??{???5:??...???6:??}客戶端路徑認證
為了在Angular應用程序訪問頁面時，要求對用戶進行身份驗證，我們將[AuthorizeGuard]應用到正在配置的路由上。
???1:??import { ApiAuthorizationModule } from 'src/api-authorization/api-authorization.module';???2:??import { AuthorizeGuard } from 'src/api-authorization/authorize.guard';???3:??import { AuthorizeInterceptor } from 'src/api-authorization/authorize.interceptor';???4:??????5:??@NgModule({???6:????declarations:?[???7:?? AppComponent,???8:?? NavMenuComponent,???9:?? HomeComponent,??10:?? CounterComponent,??11:?? FetchDataComponent??12:?? ],??13:????imports:?[??14:??????BrowserModule.withServerTransition({?appId:?'ng-cli-universal' }),??15:?? HttpClientModule,??16:?? FormsModule,??17:?? ApiAuthorizationModule,??18:?? RouterModule.forRoot([??19:????????{?path:?'',?component:?HomeComponent,?pathMatch:?'full' },??20:????????{?path:?'counter',?component:?CounterComponent?},??21:????????{?path:?'fetch-data',?component:?FetchDataComponent,?canActivate:?[AuthorizeGuard]?},??22:?? ])??23:?? ],??24:????providers:?[??25:??????{?provide:?HTTP_INTERCEPTORS,?useClass:?AuthorizeInterceptor,?multi:?true }??26:?? ],??27:????bootstrap:?[AppComponent]??28:??})??29:??export class AppModule { }帶有SignalR Hubs的Endpoint路由
在preview3中，我們將SignalR?hubs連接到最近發布的新端點路由特性中。SignalR?hub連線之前已經明確完成:
???1:??app.UseSignalR(routes =>???2:??{???3:?? routes.MapHub<ChatHub>("hubs/chat");???4:??});這意味著開發人員需要在啟動期間將控制器、Razor頁面和hubs連接到不同的位置，從而產生一系列幾乎相同的路由片段:
???1:??app.UseSignalR(routes =>???2:??{???3:?? routes.MapHub<ChatHub>("hubs/chat");???4:??});???5:??????6:??app.UseRouting(routes =>???7:??{???8:?? routes.MapRazorPages();???9:??});現在，SignalR?hub也可以通過endpoint路由進行路由分發，因此您可以在ASP.NET?Core中一站式地路由幾乎所有內容。
???1:??app.UseRouting(routes =>???2:??{???3:?? routes.MapRazorPages();???4:?? routes.MapHub<ChatHub>("hubs/chat");???5:??});Java SignalR客戶端的長輪詢
我們向Java客戶端添加了長輪詢支持，這使它能夠在不支持WebSockets的環境中建立連接。這也使您能夠在客戶端應用程序中專門選擇長輪詢傳輸。
gRPC 模板
這個預覽版引入了一個用ASP.NET?Core構建的gRPC服務的新模板。NET?Core使用一個新的gRPC框架，我們正在與谷歌合作構建。
gRPC是一個流行的RPC(遠程過程調用)框架，它為API開發提供了一種固定的契約優先方法。它使用HTTP/2進行傳輸，協議緩沖區作為接口描述語言，并提供諸如身份驗證、雙向流和流控制、取消和超時等功能。
這些模板創建了兩個項目:一個是托管于ASP.?NET?Core中的gRPC服務，以及一個用于測試它的控制臺應用程序。
這是第一個為ASP.NET?Core公開發布的gRPC預覽，并沒有實現gRPC的所有功能，但是我們正在努力使ASP.NET?Core提供所提供得最佳的gRPC體驗成為可能。請嘗試一下，并在GitHub上的grpc/grpc-dotnet上給我們反饋。
未來將會有更詳細地討論ASP.NET?Core使用gRPC的博客文章，請繼續關注。
反饋
我們希望您喜歡這個預覽版的ASP.NET?Core中的新功能！請通過在Github上提交問題讓我們知道你的想法。
原文地址：https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-core-3-0-preview-3
.NET社區新聞，深度好文，歡迎訪問公眾號文章匯總?http://www.csharpkit.com?
總結
以上是生活随笔為你收集整理的.NET Core 3.0 Preview 3中关于ASP.NET Core的更新内容的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： .net core 使用RSA获取私钥证
- 下一篇： 程会玩 | 在.NET Core里操作G