2. 程式人生 > >WCF入門教程

WCF入門教程

阿新 • • 發佈：2018-11-29

 這一系列文章的內容是從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

相關推薦

WCF入門教程

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

無廢話WCF入門教程六[一個簡單的Demo]

一、前言     前面的幾個章節介紹了很多理論基礎，如：什麼是WCF、WCF中的A、B、C。WCF的傳輸模式。本文從零開始和大家一起寫一個小的WCF應用程式Demo。     大多框架的學習都是從增、刪、改、查開始來學習的，我們學習WCF也是一樣的。從簡單來看(不包括安全、優化等相關問題)，WCF的增

無廢話WCF入門教程三[WCF的宿主]

1 <?xml version="1.0" encoding="utf-8" ?> 2 <configuration> 3 <system.serviceModel> 4 <services> 5 <service

無廢話WCF入門教程一[什麼是WCF]

1 <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="WCFTest.aspx.cs" Inherits="WCFClient.WCFTest" %> 2 3 <!DOCTYPE html PUBLIC "-//W

無廢話WCF入門教程四[WCF的配置檔案]

1 <?xml version="1.0"?> 2 <configuration> 3 <system.serviceModel> 4 5 6 <!--服務--> 7 <services>

無廢話WCF入門教程五[WCF的通訊模式]

1 //配置檔案中的 binding 指定 2 <endpoint address="" binding="wsDualHttpBinding" contract="WCFService_DualPlex.IUser"></endpoint> 3 4 //服務端介面

無廢話WCF入門教程二[WCF應用的通訊過程]

1 <?xml version="1.0" encoding="utf-8"?> 2 3 <!-- 4 有關如何配置 ASP.NET 應用程式的詳細訊息，請訪問 5 http://go.microsoft.com/fwlink/?LinkId=169433 6

WCF的入門教程dome（一）

基本上 logs 庫服務器 aid model bar urn borde tns 一、概述 　　Windows Communication Foundation(WCF)是由微軟發展的一組數據通信的應用程序開發接口，可以翻譯為Windows通訊接口，它是.NET框架的一

WCF系列教程之消息交換模式之請求與答復模式(Request/Reply)

人員 point program enabled col ise sleep wds 類型 1、使用WCF請求與答復模式須知 (1)、客戶端調用WCF服務端需要等待服務端的返回,即使返回類型是void (2)、相比Duplex來講，這種模式強調的是客戶端的被動接受，也就是說

函數式編程入門教程（轉）

制作 說明 讀取 ttf 中國 png if...else per 部分 初涉函數式編程語言python,轉載了一篇文章，先簡單來了解一下函數式編程的概念. 文章原址：http://www.ruanyifeng.com/blog/2017/02/fp-tutorial.ht

WCF系列教程之WCF服務宿主

class ati 托管 系列 msm scm 打開 實例 部分 本文參考自http://www.cnblogs.com/wangweimutou/p/4377062.html,純屬讀書筆記,加深記憶。 一、簡介 任何一個程序的運行都需要依賴一個確定的進程中,WCF也不例外

WCF系列教程之客戶端異步調用服務

1.5 void 添加引用 dsl idt pan important 配置 但是 本文參考自http://www.cnblogs.com/wangweimutou/p/4409227.html,純屬讀書筆記,加深記憶 一、簡介 在前面的隨筆中,詳細的介紹了WCF客戶端服務

CodeIgniter 入門教程第一篇：信息發布

per 所有 控制 知識點 image doc ref har 提交 一、MVC CodeIgniter 采用MVC架構即：控制層、模型層和視圖層。 對應Application下面的文件夾 （圖1）： 所有新建文件以.php結尾 視圖層

WCF系列教程之WCF服務協定

需要 通信 mes 配置 ace 交換 對象 web服務 程序 本文參考自:http://www.cnblogs.com/wangweimutou/p/4422883.html,純屬讀書筆記,加深記憶 一、服務協定簡介: 1、WCF所有的服務協定層裏面的服務接口,都有一個S

WCF系列教程之WCF實例化

說明 con bind () 應用程序 ebe 控制臺應用程序 alt .text 本文參考自http://www.cnblogs.com/wangweimutou/p/4517951.html,純屬讀書筆記,加深記憶 一、理解WCF實例化機制 1、WCF實例化,是指對用戶

Java - Struts框架教程 Hibernate框架教程 Spring框架入門教程（新版） sping mvc spring boot spring cloud Mybatis

java ee cloud pac .cn java get pin nat 輕量級 https://www.zhihu.com/question/21142149 http://how2j.cn/k/hibernate/hibernate-tutorial/31.html

Django REST framework 的快速入門教程

ret turn ads 使用 blog 所有 定義 想去 cti CRM-API項目搭建 序列器（Serializers） 首先，我們來定義一些序列器。我們來創建一個新的模塊（module）叫做 crm/rest_searializer.py ，這是我們用來描述數據是如何

Jade模板引擎入門教程

undefine 文件 ech content arrays str www versions contain Jade是一款高性能簡潔易懂的模板引擎，Jade是Haml的Javascript實現，在服務端（NodeJS）及客戶端均有支持。 功能 客戶端支持 超強的可讀性

Webpack新手入門教程(學習筆記)

自身 方式 pin 演示 要求 const 初學者 功能 plugins p.p1 { margin: 0.0px 0.0px 0.0px 0.0px; text-align: center; font: 30.0px Helvetica; color: #000000 }

gulp入門教程

綠色 實現 save lan 當前 包管理 安裝插件 列出文件 編寫 　　　 　　gulp是什麽？ 　　　　gulp是前端開發過程中對代碼進行構建的工具，是自動化項目的構建利器；它不僅能對網站資源進行優化，而且在開發過程中很多重復的任務能夠使用正確的工具自動完成；使