WCF入門教程

来源:https://www.cnblogs.com/xu-yi/archive/2018/11/28/10035821.html
-Advertisement-
Play Games

這一系列文章的內容是從MSDN中COPY過來的，講述的是最簡單的WCF程式示例：如何在控制台應用程式實現和承載WCF服務，以及如何創建、配置和使用WCF客戶端。 文章主體可分為兩部分，分別介紹伺服器端和客戶端的編程實現。細分的話，可以分為六項任務。 伺服器端 定義WCF服務協定（任務一） 這是創建基 ...


 這一系列文章的內容是從MSDN中COPY過來的，講述的是最簡單的WCF程式示例：如何在控制台應用程式實現和承載WCF服務，以及如何創建、配置和使用WCF客戶端。

   文章主體可分為兩部分，分別介紹伺服器端和客戶端的編程實現。細分的話，可以分為六項任務。

  • 伺服器端

定義WCF服務協定（任務一）

   這是創建基本 Windows Communication Foundation (WCF) 服務和可以使用該服務的客戶端所需的六項任務中的第一項任務。

   創建基本 WCF 服務時，第一項任務是為與外界共用的服務創建協定，併在其中描述如何與該服務進行通信。

 

   具體步驟為：   

   1、 創建新的控制台應用程式項目。 在“新建項目”對話框中，選中“Visual Basic”或“Visual C#”，並選擇“控制台應用程式”模板，並命名為Service。 使用預設的位置。

   2、將預設的Service 命名空間更改為 Microsoft.ServiceModel.Samples。

   3、為項目提供對 System.ServiceModel 命名空間的引用：右擊“解決方案資源管理器”中的“Service”項目，選擇“添加引用”項，在彈出的對話框中的“.NET”選項卡裡的“組件名稱”中選擇“System.ServiceModel”，然後單擊“確定”。

 

   下麵是編程步驟：

   1、為 System.ServiceModel 命名空間添加一個 using 語句。      

      using System.ServiceModel;

   2、創建一個新的ICalculator 介面，並將 ServiceContractAttribute 屬性應用於該介面，並將 Namespace 值設置為“http://Microsoft.ServiceModel.Samples”。 此命名空間指定該服務在電腦上的路徑，並構成該服務的基址部分。 請註意，在通過採用方括弧表示法的屬性來批註介面或類時，該屬性類可以從其名稱中去掉“Attribute”部分。

    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")] 

    public interface ICalculator

   3、在介面中創建方法聲明，並將 OperationContractAttribute 屬性應用於每個要作為公共 WCF 協定的一部分公開的方法。    

   [OperationContract]

   double Add(double n1, double n2);

   [OperationContract]

   double Subtract(double n1, double n2);

   [OperationContract]

   double Multiply(double n1, double n2);

   [OperationContract]

   double Divide(double n1, double n2);

   

 

   下麵是創建服務協定的完整代碼段：   

using System;

// Add the using statement for the Sytem.ServiceModel namespace

using System.ServiceModel;

namespace Microsoft.ServiceModel.Samples

{

  //  Define a service contract.

  [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]

  public interface ICalculator

  {

    //  Create the method declaration for the contract.

    [OperationContract]

    double Add(double n1, double n2);

    [OperationContract]

    double Subtract(double n1, double n2);

    [OperationContract]

    double Multiply(double n1, double n2);

    [OperationContract]

    double Divide(double n1, double n2);

  }

}

........（整個伺服器端的代碼未完，等講完任務三時，再給出完整代碼）

 

實現WCF服務協定（任務二）

   1、創建一個新 CalculatorService 類，該類從用戶定義的 ICalculator 介面繼承而來並實現該介面定義的協定功能。   

   public class CalculatorService : ICalculator

   

   2、實現每個算術運算符的功能。

    

public double Add(double n1, double n2)

{

    double result = n1 + n2;

    Console.WriteLine("Received Add({0},{1})", n1, n2);

    // Code added to write output to the console window.

    Console.WriteLine("Return: {0}", result);

    return result;

}

 

public double Subtract(double n1, double n2)

{

    double result = n1 - n2;

    Console.WriteLine("Received Subtract({0},{1})", n1, n2);

    Console.WriteLine("Return: {0}", result);

    return result;

}

 

public double Multiply(double n1, double n2)

{

    double result = n1 * n2;

    Console.WriteLine("Received Multiply({0},{1})", n1, n2);

    Console.WriteLine("Return: {0}", result);

    return result;

}

 

public double Divide(double n1, double n2)

{

    double result = n1 / n2;

    Console.WriteLine("Received Divide({0},{1})", n1, n2);

    Console.WriteLine("Return: {0}", result);

    return result;

}

 

   在創建和實現了服務協定後，下一步是運行該服務。 運行服務由三個步驟組成：配置、承載和打開服務。

配置、承載和運行服務（任務三）

  • 為服務配置基址   

    為服務的基址創建 Uri 實例。 此 URI 指定 HTTP 方案、本地電腦、埠號 8000，以及服務協定中為服務命名空間指定的服務路徑ServiceModelSample/Services。    

    Uri baseAddress = new Uri("http://localhost:8000/ServiceModelSamples/Service");

  • 承載服務
  1. 創建一個新的 ServiceHost 實例以承載服務。 必須指定實現服務協定和基址的類型。 對於此示例，我們將基址指定為http://localhost:8000/ServiceModelSamples/Services，並將 CalculatorService 指定為實現服務協定的類型。

ServiceHost selfHost = new ServiceHost(typeof(CalculatorService), baseAddress);
  1. 添加一個捕獲 CommunicationException 的 try-catch 語句，併在接下來的三個步驟中將該代碼添加到 try 塊中。
  2. 添加公開服務的終結點。 為此，必須指定終結點公開的協議、綁定和終結點的地址。 此例中，將 ICalculator 指定為協定，將 WSHttpBinding 指定為綁定，並將 CalculatorService 指定為地址。 在這裡請註意，我們指定的是相對地址。 終結點的完整地址是基址和終結點地址的組合。 在此例中，完整地址是 http://localhost:8000/ServiceModelSamples/Services/CalculatorService。

selfHost.AddServiceEndpoint(

    typeof(ICalculator),

    new WSHttpBinding(),

    "CalculatorService");
  1. 啟用元數據交換。 為此，必須添加服務元數據行為。 首先創建一個 ServiceMetadataBehavior 實例，將 HttpGetEnabled 屬性設置為 true，然後為服務添加新行為。

ServiceMetadataBehavior smb = new ServiceMetadataBehavior();

smb.HttpGetEnabled = true;

selfHost.Description.Behaviors.Add(smb);
  1. 打開 ServiceHost 並等待傳入消息。 用戶按 Enter 鍵時，關閉 ServiceHost。

    selfHost.Open();

    Console.WriteLine("The service is ready.");

    Console.WriteLine("Press <ENTER> to terminate service.");

    Console.WriteLine();

    Console.ReadLine();

    // Close the ServiceHostBase to shutdown the service.

    selfHost.Close();

 

    下麵是伺服器端（即“Service”項目中program.cs文件中）的完整程式代碼：

using System;

using System.ServiceModel;

using System.ServiceModel.Description;

 

namespace Microsoft.ServiceModel.Samples

{

    // Define a service contract.

    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]

    public interface ICalculator

    {

        [OperationContract]

        double Add(double n1, double n2);

        [OperationContract]

        double Subtract(double n1, double n2);

        [OperationContract]

        double Multiply(double n1, double n2);

        [OperationContract]

        double Divide(double n1, double n2);

    }

 

    // Service class that implements the service contract.

    // Added code to write output to the console window.

    public class CalculatorService : ICalculator

    {

        public double Add(double n1, double n2)

        {

            double result = n1 + n2;

            Console.WriteLine("Received Add({0},{1})", n1, n2);

            Console.WriteLine("Return: {0}", result);

            return result;

        }

 

        public double Subtract(double n1, double n2)

        {

            double result = n1 - n2;

            Console.WriteLine("Received Subtract({0},{1})", n1, n2);

            Console.WriteLine("Return: {0}", result);

            return result;

        }

 

        public double Multiply(double n1, double n2)

        {

            double result = n1 * n2;

            Console.WriteLine("Received Multiply({0},{1})", n1, n2);

            Console.WriteLine("Return: {0}", result);

            return result;

        }

 

        public double Divide(double n1, double n2)

        {

            double result = n1 / n2;

            Console.WriteLine("Received Divide({0},{1})", n1, n2);

            Console.WriteLine("Return: {0}", result);

            return result;

        }

    }

 

 

    class Program

    {

        static void Main(string[] args)

        {

 

            // Create a URI to serve as the base address.

            Uri baseAddress = new Uri("http://localhost:8000/ServiceModelSamples/Service");

 

            // Create ServiceHost

            ServiceHost selfHost = new ServiceHost(typeof(CalculatorService), baseAddress);

            try

            {

                 //  Add a service endpoint.

                selfHost.AddServiceEndpoint(

                    typeof(ICalculator),

                    new WSHttpBinding(),

                    "CalculatorService");

 

                // Enable metadata exchange.

                ServiceMetadataBehavior smb = new ServiceMetadataBehavior();

                smb.HttpGetEnabled = true;

                selfHost.Description.Behaviors.Add(smb);

 

                // Start (and then stop) the service.

                selfHost.Open();

                Console.WriteLine("The service is ready.");

                Console.WriteLine("Press <ENTER> to terminate service.");

                Console.WriteLine();

                Console.ReadLine();

 

                // Close the ServiceHostBase to shutdown the service.

                selfHost.Close();

            }

            catch (CommunicationException ce)

            {

                Console.WriteLine("An exception occurred: {0}", ce.Message);

                selfHost.Abort();

            }

        }

    }

}

若要運行服務，啟動項目文件夾下bin目錄中的 Service.exe即可。

 前面三篇文章是講伺服器端的部署和運行，下麵講講客戶端如何配置和使用。

創建WCF客戶端（任務四）

  1. 通過執行以下步驟，在 Visual Studio 2005 中為客戶端創建新項目：
    1. 在包含該服務（之前文章所述的服務）的同一解決方案中的“解決方案資源管理器”（位於右上角）中，右擊當前解決方案，然後選擇“添加新項目”。
    2. 在“添加新項目”對話框中，選擇“Visual Basic”或“Visual C#”，選擇“控制台應用程式”模板，然後將其命名為 Client。 使用預設的位置。
    3. 單擊“確定”。
    4. 為項目提供對 System.ServiceModel 命名空間的引用：在“解決方案資源管理器”中右擊“Service”項目，從“.NET”選項卡上的“組件名稱”列中選擇“System.ServiceModel”，然後單擊“確定”。
    5. 為 System.ServiceModel 命名空間添加 using 語句：using System.ServiceModel;
    6. 啟動在前面的步驟中創建的服務。（即打開在伺服器項目中生成的Service.exe可執行文件）
    7. 通過執行以下步驟，使用適當的開關運行Service Model Metadata Utility Tool (SvcUtil.exe) 以創建客戶端代碼和配置文件：
      1. 通過選擇“開始”菜單中的“Microsoft Windows SDK”項下的“CMD Shell”，啟動 Windows SDK 控制台會話。
      2. 導航到要放置客戶端代碼的目錄。 如果使用預設設置創建 Client 項目，則目錄為 C:\Documents and Settings\<用戶名>\Documents\Visual Studio 2008\Projects\Service\Client。
      3. 將命令行工具Service Model Metadata Utility Tool (SvcUtil.exe) 與適當的開關一起使用以創建客戶端代碼。 下麵的示例生成服務的代碼文件和配置文件。

svcutil.exe /language:cs /out:generatedProxy.cs /config:app.config http://localhost:8000/ServiceModelSamples/service

  1. 在 Visual Studio 中將生成的代理添加到 Client 項目中，方法是在“解決方案資源管理器”中右擊“Client”並選擇“添加現有項”。 然後選擇在上一步中生成的 generatedProxy.cs 文件。

配置WCF客戶端（任務五）

    在 Visual Studio 中，將在前一過程中生成的 App.config 配置文件添加到客戶端項目中。 在“解決方案資源管理器”中右擊該客戶端，選擇“添加現有項”，然後從 C:\Documents and Settings\<用戶名>\Documents\Visual Studio 2008\Projects\Service\Client\bin 目錄中選擇 App.config 配置文件。

    將app.config添加到項目中後，就算是完成了wcf客戶端的配置。因為具體的配置信息，我們在使用svcutil.exe工具時，它就幫我們配置好並寫入了app.config文件。

 

使用WCF客戶端（任務六）

1、為要調用的服務的基址創建 EndpointAddress 實例，然後創建 WCF Client 對象。

    //Create an endpoint address and an instance of the WCF Client.

    EndpointAddress epAddress = new EndpointAddress("http://localhost:8000/ServiceModelSamples/Service/CalculatorService");

    CalculatorClient client = new CalculatorClient(new WSHttpBinding(), epAddress);

2、從 Client 內調用客戶端操作。

// Call the service operations.

// Call the Add service operation.

double value1 = 100.00D;

double value2 = 15.99D;

double result = client.Add(value1, value2);

Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

 

// Call the Subtract service operation.

value1 = 145.00D;

value2 = 76.54D;

result = client.Subtract(value1, value2);

Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

 

// Call the Multiply service operation.

value1 = 9.00D;

value2 = 81.25D;

result = client.Multiply(value1, value2);

Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

 

// Call the Divide service operation.

value1 = 22.00D;

value2 = 7.00D;

result = client.Divide(value1, value2);

Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

3、在 WCF 客戶端上調用 Close。

// Closing the client gracefully closes the connection and cleans up resources.

client.Close();

下麵是客戶端的完整代碼：

using System;

using System.Collections.Generic;

using System.Text;

using System.ServiceModel;

 

namespace ServiceModelSamples

{

    class Client

    {

        static void Main()

        {

    //Step 1: Create an endpoint address and an instance of the WCF Client.

            EndpointAddress epAddress = new EndpointAddress("http://localhost:8000/ServiceModelSamples/Service/CalculatorService");

            CalculatorClient client = new CalculatorClient(new WSHttpBinding(), epAddress);

 

            // Step 2: Call the service operations.

            // Call the Add service operation.

            double value1 = 100.00D;

            double value2 = 15.99D;

            double result = client.Add(value1, value2);

            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

 

            // Call the Subtract service operation.

            value1 = 145.00D;

            value2 = 76.54D;

            result = client.Subtract(value1, value2);

            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

 

            // Call the Multiply service operation.

            value1 = 9.00D;

            value2 = 81.25D;

            result = client.Multiply(value1, value2);

            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

 

            // Call the Divide service operation.

            value1 = 22.00D;

            value2 = 7.00D;

            result = client.Divide(value1, value2);

            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

 

            //Step 3: Closing the client gracefully closes the connection and cleans up resources.

            client.Close();

 

            Console.WriteLine();

            Console.WriteLine("Press <ENTER> to terminate client.");

            Console.ReadLine();

 

        }

    }

}

若要啟動客戶端，請在“開始”菜單中的“Microsoft Windows SDK”項下選擇“CMD Shell”，從而啟動 Windows SDK 控制台會話。 定位至 C:\Documents and Settings\<用戶名>\Documents\Visual Studio 2008\Projects\Service\Client\obj\Debug 目錄，鍵入 client，然後按Enter。 操作請求和響應將出現在客戶端控制台視窗中，如下所示。

Add(100,15.99) = 115.99

Subtract(145,76.54) = 68.46

Multiply(9,81.25) = 731.25

Divide(22,7) = 3.14285714285714

 

Press <ENTER> to terminate client.

 

最後，附上我的ASP.NET學習群，歡迎各位同行入群指導交流。技術群：【ASP.NET技術社區】872894940


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • python_學生信息管理實例
    """提示：代碼中的內容均被註釋，請參考，切勿照搬""" """註意:代碼切勿照搬，錯誤請留言指出""" ...
  • 洛谷P2792 [JSOI2008]小店購物(最小樹形圖)
    題意 "題目鏈接" Sol 一開始的思路：新建一個虛點向每個點連邊，再加上題面中給出的邊，邊權均為大小 需要購買的數量 然後發現死活都過不去 看了題解才發現題目中有個細節——買了$A$就可以買$B$，但是人家沒告訴你必須買夠$A$的數量才能買$B$呀qwqqqqqqq 所以建圖的時候只算一次貢獻就行 ...
  • sql表連接的幾種方式
    這裡有兩張表TableA和TableB，分別是姓名錶和年齡表，用於我們例子的測試數據： 表連接有幾種? sql表連接分成外連接、內連接和交叉連接。 一.外連接 概述： 外連接包括三種,分別是左外連接、右外連接、全外連接。 對應的sql關鍵字:LEFT/RIGHT/FULL OUTER JOIN,通常 ...
  • Python常用Tips
    pip安裝使用 i參數指定源 指定豆瓣源，快如閃電：pip install i http://pypi.douban.com/simple/ 使用sys.modules查看導入包的路徑 sys.modules是一個全局字典，可以通過它來瞭解當前環境載入了什麼包，包的路徑 ...
  • Kibana安裝及使用說明
    Kibana安裝及使用說明 Kibana是一個針對Elasticsearch的開源分析及可視化平臺，用來搜索、查看交互存儲在Elasticsearch索引中的數據。 官方地址：https://www.elastic.co/cn/products/kibana 一、Kibana安裝 1.環境準備 Ki ...
  • 進程一
    一、什麼是進程 進程（Process）是電腦中的程式關於某數據集合上的一次運行活動，是系統進行資源分配和調度的基本單位，是操作系統結構的基礎。在早期面向進程設計的電腦結構中，進程是程式的基本執行實體；在當代面向線程設計的電腦結構中，進程是線程的容器。程式是指令、數據及其組織形式的描述，進程是程 ...
  • 關於leal和mov
    最近在學習leal的時候遇到了一點非常迷惑的地方，就是leal是用來取有效地址的，但是為什麼它也可以實現賦值呢？偶然發現一個博客講的不錯，遂自己記錄一下 一個這樣的例子 如果寄存器edx裡面存的值為x，我們知道這句結束之後edx裡面的值會被置為5x+7，但是看起來為什麼是值而不是地址呢？ 實際上這之 ...
  • Core官方DI解析(4)--CallSiteRuntimeResolver
    ​ 類型是一個創建或獲取服務實例的類型,這個類型繼承了 這個類型,也是使用了訪問者模式,下麵一一來解析此類 ServiceProviderEngineScope 在解析 之前先看一下 類型,這個類型就可以是一個容器類型,最後實例化的服務對象就緩存在此類之中, 從下麵代碼中可以看出此類實現了 和`IS ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類