訓練
模組
在 .NET MAUI 應用程式中取用 REST Web 服務 - Training
使用 HTTPClient 取用 REST Web 服務並執行基本 CRUD 作業。 為了提供良好使用者體驗,您將會偵測裝置是否已連線到網際網路,並利用原生網路堆疊取得最佳效能。
本主題討論 Windows Communication Foundation (WCF) 4.5 版的新功能。
gRPC 是新式 RPC 架構,是 WCF 的熱門替代方案。 gRPC 建置在 HTTP/2 之上,可提供一些優於 WCF 的優點,包括:
如需開發或移轉 WCF 應用程式至 gRPC 的詳細資訊,請參閱:
為了使 WCF 4.5 應用程式更容易開發和維護,我們已投入了大量的努力。 如需詳細資訊,請參閱 WCF 簡化功能。
根據預設,[加入服務參考] 可產生傳回工作的非同步服務作業方法。 也可使用同步和非同步方法。 使用這種全新且以工作為基礎的非同步程式設計模型,可讓您以非同步方式呼叫服務作業。 當您呼叫所產生的 Proxy 方法時,WCF 會建構 Task 物件以代表非同步作業,並將該 Task 傳回給您。 工作會在作業完成時完成。 在實作非同步作業時,您可將其實作為以工作為基礎的非同步作業。 如需詳細資訊,請參閱同步和非同步作業。
當您在 Visual Studio 中加入服務參考,或使用 SvcUtil.exe 工具時,用戶端組態檔就會產生。 在舊版 WCF 中,這些組態檔會包含所有繫結屬性的值,即使值為預設值,也是如此。 在 WCF 4.5 中產生的組態檔只會包含那些設定成非預設值的繫結屬性。
如需詳細資訊,請參閱 WCF 簡化功能。
WCF 現可支援合約優先開發。 svcutil.exe 有 /serviceContract 參數可讓您從 WSDL 文件產生服務與資料合約。
可攜式子集專案可讓 .NET 組件程式設計人員維護單一來源的樹狀目錄和建置系統,同時還支援多個 .NET 平台 (桌上型電腦、Silverlight、Windows Phone 和 Xbox)。 可攜子集專案唯一參考的 .NET 可攜程式庫為適用於任何 .NET 平台的組件。 開發人員的體驗與在任何其他 WCF 用戶端應用程式內加入服務參考相同。 如需詳細資訊,請參閱在可攜式子集專案中新增服務參考。
WCF 會在寫入 WCF 服務時提供 ASP.NET 相容模式,將 ASP.NET HTTP 管線功能的完整存取權限授與開發人員。 若要使用這個模式,您必須在 web.config 的 <serviceHostingEnvironment> 區段中將 aspNetCompatibilityEnabled
屬性設定為 true。此外,這個 appDomain 中的任何服務還必須將其 AspNetCompatibilityRequirementsAttribute 上的 RequirementsMode
屬性設定為 Allowed 或 Required。 根據預設,AspNetCompatibilityRequirementsAttribute 現在會設定為 Allowed。 如需詳細資訊,請參閱 WCF 服務和 ASP.NET。
為了簡化組態,我們已變更一些傳輸屬性的預設值。 如需詳細資訊,請參閱 WCF 簡化功能。
XmlDictionaryReaderQuotas 包含 XML 字典讀取器的可設定配額值,這些值會限制編碼器在建立訊息時使用的記憶體量。 雖然這些配額是可設定的,但變更為預設值可降低開發人員必須明確設定這些值的機率。 如需詳細資訊,請參閱 WCF 簡化功能。
Visual Studio 現在有一部分建置流程會針對專案中定義的屬性來驗證 WCF 組態檔。 如果驗證失敗,將會在 Visual Studio 中顯示驗證錯誤或警告的清單。
為了協助新的和現有的 WCF 服務開發人員設定其服務,現在每個屬於服務組態檔之一部分的組態項目及其屬性,Visual Studio XML 編輯器都有提供工具提示。
加入對真正非同步資料流處理的支援,如果接收端不是正在讀取或是讀取速度緩慢,傳送端現在不會封鎖執行緒,延展性因此提升。 移除對用戶端發送資料流訊息至 IIS 裝載之 WCF 服務時的訊息緩衝限制。 如需詳細資訊,請參閱 WCF 簡化功能。
已加入 HTTPS 通訊協定對應以簡化透過 HTTPS 公開端點的程序。 若要啟用 HTTPS 端點,請確定您的網站已設定 HTTPS 繫結和 SSL 憑證,然後只需為裝載服務的虛擬目錄啟用 HTTPS 即可。 如果服務的中繼資料已啟用,也會透過 HTTPS 加以公開。
某些協力廠商 WSDL 處理堆疊無法處理透過 xsd:import 相依於其他文件的 WSDL 文件。 WCF 現在允許您指定以單一文件來傳回所有 WSDL 資訊。 如需要求單一 WSDL 文件,當您向服務要求中繼資料時,請將 "?singleWSDL" 附加至 URI。
WebSockets 是透過連接埠 80 和 443 提供真正雙向通訊的技術,其效能特性與 TCP 類似。 為了支援透過 WebSocket 傳輸進行通訊,我們已加入兩個新的繫結。 NetHttpBinding 和 NetHttpsBinding。 如需詳細資訊,請參閱:系統提供的繫結。
下列資料表說明已變更的設定以及可找到其他資訊的位置。
屬性 | 另一 | 新的預設值 | 如需詳細資訊,請參閱 |
---|---|---|---|
channelInitializationTimeout | NetTcpBinding | 30 秒 | ChannelInitializationTimeout |
listenBacklog | NetTcpBinding | 12 * 處理器的數量 | ListenBacklog |
maxPendingAccepts | ConnectionOrientedTransportBindingElement SMSvcHost.exe |
2 * 用於傳輸的處理器數量 4 * 用於 SMSvcHost.exe 的處理器數量 |
MaxPendingAccepts設定 Net.TCP 連接埠共用服務 |
maxPendingConnections | ConnectionOrientedTransportBindingElement | 12 * 處理器的數量 | MaxPendingConnections |
receiveTimeout | SMSvcHost.exe | 30 秒 | 設定 Net.TCP 連接埠共用服務 |
Windows Communication Foundation (WCF) 可讓開發人員使用組態檔或程式碼來設定服務。 當服務需要在部署後進行設定時,組態檔非常有用。 使用組態檔時,IT 專業人員只需更新組態檔,不必重新編譯。 但是組態檔可能會很複雜而難以維護。 由於不支援組態檔偵錯,而且組態項目是以名稱來參考,這使得製作組態檔容易出錯且難度增加。 WCF 也允許您以程式碼來設定服務。 在舊版 WCF (4.0 及更早版本) 的在自我裝載案例中,您可以輕鬆使用程式碼來設定服務,因為 ServiceHost 類別可讓您在呼叫 ServiceHost.Open 之前設定端點和行為。 但是在 Web 裝載案例中,您就無法存取 ServiceHost 類別。 為了設定 Web 裝載服務,您需要建立會建立 System.ServiceModel.ServiceHostFactory
的 ServiceHostFactory,並執行任何所需的設定。 從 .NET Framework 4.5 開始,WCF 提供了更簡單的方法,以程式碼來設定自我裝載和 Web 裝載服務。 如需詳細資訊,請參閱在程式碼中設定 WCF 服務。
WCF 用戶端應用程式會使用 ChannelFactory<TChannel> 類別來建立與 WCF 服務的通訊通道。 建立 ChannelFactory<TChannel> 執行個體會產生額外負荷,因為這涉及到下列作業:
建構 ContractDescription 樹狀
反映所有必要的 CLR 型別
建構通道堆疊
處置資源
為了盡量減少這種負荷,WCF 可以在您使用 WCF 用戶端 Proxy 時快取通道處理站。 如需詳細資訊,請參閱通道處理站和快取。
從 WCF 4.5 開始,WCF 二進位編碼器加入壓縮的支援。 壓縮型別是透過 CompressionFormat 屬性來設定。 用戶端和服務都必須設定 CompressionFormat 屬性。 壓縮適用於 HTTP、HTTPS 和 TCP 通訊協定。 如果用戶端指定要使用壓縮,但服務不支援這項功能,則會擲回通訊協定例外狀況以表示通訊協定不相符。 如需詳細資訊,請參閱選擇訊息編碼器。
已新增 UDP 傳輸的支援,這可讓開發人員撰寫使用「射後不理」(Fire And Forget) 傳訊的服務。 用戶端傳送訊息給服務,而不期待服務發出任何回應。
已加入支援,如同 IIS 的支援一樣,在使用 HTTP 傳輸與傳輸安全性時,於單一 WCF 端點上支援多個驗證模式。 IIS 允許您在虛擬目錄上啟用多個驗證模式,這項功能可讓單一 WCF 端點支援裝載 WCF 服務之虛擬目錄所啟用的多個驗證模式。
已加入支援,並允許具有國際化網域名稱的 WCF 服務。 如需詳細資訊,請參閱 WCF 和國際化網域名稱。
已加入名稱為 HttpClient 的新類別,使得處理 HTTP 要求大為方便。 如需詳細資訊,請參閱 HttpClient 和使用 HttpClient 的指導方針。
在組態檔中,對於專案內定義之自訂屬性的屬性值現可支援 IntelliSense 功能,以協助您快速準確地處理組態檔。
WCF 元素和屬性目前在 XML 編輯器中會有工具提示,以協助您輕鬆並準確地識別元素或屬性的用途。
在 WCF 專案中,定義於 XML 的資料型別 (例如服務中所公開的項目) 可以直接貼到程式碼頁面上。 XML 型別會以 CLR 型別貼上。 如需詳細資訊,請參閱從 XML 產生資料型別類別。
在 Visual Studio 2010 中,不論您是否明確指定端點,WebServiceHost 都會自動建立預設端點。 在 Visual Studio 2012 和更新版本中,WebServiceHost 只有在沒有明確新增的端點時才會建立預設端點。 如果您的用戶端想要預設端點,您可以明確新增端點並將用戶端指向該端點。 或者,您可以將下列設定加入您應用程式的組態檔,告知 WCF 還原成之前的行為
<appSettings>
<add key="wcf:webservicehost:enableautomaticendpointscompatability" value="true"/>
</appSettings>
這個由 IChannelFactory<TChannel> 公開的介面,可讓您在用戶端上更輕鬆地使用 Cookie。 當繫結上的 AllowCookies 設定為 true 時,您可使用下列程式碼存取 Cookie:
IHttpCookieContainerManager cookieManager = factory.GetProperty<IHttpCookieContainerManager>();
System.Net.CookieContainer container = cookieManager.CookieContainer;
之後,您即可從 CookieContainer 擷取或設定 Cookie。 當 AllowCookies 設為 false 時,您可使用 OperationContext 手動擷取 Cookie,並使用另一個 OperationContext 或訊息偵測器,在其他要求中傳送此 Cookie。 IHttpCookieContainerManager 介面可讓您驗證使用者與服務,並使用該服務傳回的驗證 Cookie 來驗證其他服務。
訓練
模組
在 .NET MAUI 應用程式中取用 REST Web 服務 - Training
使用 HTTPClient 取用 REST Web 服務並執行基本 CRUD 作業。 為了提供良好使用者體驗,您將會偵測裝置是否已連線到網際網路,並利用原生網路堆疊取得最佳效能。