教程：承载和运行基本的 Windows Communication Foundation 服务

项目
05/10/2023

本教程介绍创建基本 Windows Communication Foundation (WCF) 应用程序所要完成的五个任务中的第三个任务。有关教程概述，请参阅教程：Windows Communication Foundation 应用程序入门。

创建 WCF 应用程序所要完成的下一个任务是在控制台应用程序中承载一个 WCF 服务。 WCF 服务公开一个或多个终结点，其中的每个终结点公开一项或多项服务操作。服务终结点指定以下信息：

一个地址，可在其中找到服务。
一个绑定，其中包含用于描述客户端必须如何与服务通信的信息。
一个协定，用于定义服务向其客户端提供的功能。

本教程介绍如何执行下列操作：

创建并配置用于承载 WCF 服务的控制台应用项目。
添加代码以承载 WCF 服务。
更新配置文件。
启动 WCF 服务并验证它是否正在运行。

创建并配置用于承载服务的控制台应用项目

在 Visual Studio 中创建一个控制台应用项目：
1. 在“文件”菜单中，选择“打开”>“项目/解决方案”，然后浏览到先前创建的 GettingStarted 解决方案 (GettingStarted.sln)。选择“打开” 。
2. 从“视图”菜单中选择“解决方案资源管理器”。
3. 在“解决方案资源管理器”窗口中，选择“GettingStarted”解决方案（顶部节点），然后从快捷菜单中选择“添加”>“新建项目”。
4. 在左侧的“添加新项目”窗口中，选择“Visual C#”或“Visual Basic”下的“Windows 桌面”类别。
5. 选择“控制台应用(.NET Framework)”模板，然后输入“GettingStartedHost”作为名称。选择“确定”。
将“GettingStartedHost”项目中的引用添加到“GettingStartedLib”项目：
1. 在“解决方案资源管理器”窗口中，选择“GettingStartedHost”项目下的“References”文件夹，然后从快捷菜单中选择“添加引用”。
2. 在“添加引用”对话框中，在窗口左侧的“项目”下选择“解决方案”。
3. 在窗口的中间部分选择“GettingStartedLib”，然后选择“确定”。
  
  此操作将使“GettingStartedLib”项目中定义的类型可用于“GettingStartedHost”项目。
将“GettingStartedHost”项目中的引用添加到 System.ServiceModel 程序集：
1. 在“解决方案资源管理器”窗口中，选择“GettingStartedHost”项目下的“References”文件夹，然后从快捷菜单中选择“添加引用”。
2. 在“添加引用”窗口中左侧的“程序集”下，选择“框架”。
3. 依次选择“System.ServiceModel”、“确定”。
4. 选择“文件”>“全部保存”以保存解决方案。

添加代码以承载服务

若要承载服务，请添加代码以执行以下步骤：

为基址创建一个 URI。
创建一个用于承载服务的类实例。
创建服务终结点。
启用元数据交换。
打开服务主机以侦听传入的消息。

对代码进行以下更改：

打开“GettingStartedHost”项目中的“Program.cs”或“Module1.vb”文件，将其代码替换为以下代码：

using System;
using System.ServiceModel;
using System.ServiceModel.Description;
using GettingStartedLib;

namespace GettingStartedHost
{
    class Program
    {
        static void Main(string[] args)
        {
            // Step 1: Create a URI to serve as the base address.
            Uri baseAddress = new Uri("http://localhost:8000/GettingStarted/");

            // Step 2: Create a ServiceHost instance.
            ServiceHost selfHost = new ServiceHost(typeof(CalculatorService), baseAddress);

            try
            {
                // Step 3: Add a service endpoint.
                selfHost.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(), "CalculatorService");

                // Step 4: Enable metadata exchange.
                ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
                smb.HttpGetEnabled = true;
                selfHost.Description.Behaviors.Add(smb);

                // Step 5: Start the service.
                selfHost.Open();
                Console.WriteLine("The service is ready.");

                // Close the ServiceHost to stop the service.
                Console.WriteLine("Press <Enter> to terminate the service.");
                Console.WriteLine();
                Console.ReadLine();
                selfHost.Close();
            }
            catch (CommunicationException ce)
            {
                Console.WriteLine("An exception occurred: {0}", ce.Message);
                selfHost.Abort();
            }
        }
    }
}

Imports System.ServiceModel
Imports System.ServiceModel.Description
Imports GettingStartedLib.GettingStartedLib

Module Service

    Class Program
        Shared Sub Main()
            ' Step 1: Create a URI to serve as the base address.
            Dim baseAddress As New Uri("http://localhost:8000/GettingStarted/")

            ' Step 2: Create a ServiceHost instance.
            Dim selfHost As New ServiceHost(GetType(CalculatorService), baseAddress)
           Try

                ' Step 3: Add a service endpoint.
                selfHost.AddServiceEndpoint( _
                    GetType(ICalculator), _
                    New WSHttpBinding(), _
                    "CalculatorService")

                ' Step 4: Enable metadata exchange.
                Dim smb As New ServiceMetadataBehavior()
                smb.HttpGetEnabled = True
                selfHost.Description.Behaviors.Add(smb)

                ' Step 5: Start the service.
                selfHost.Open()
                Console.WriteLine("The service is ready.")

                ' Close the ServiceHost to stop the service.
                Console.WriteLine("Press <Enter> to terminate the service.")
                Console.WriteLine()
                Console.ReadLine()
                selfHost.Close()

            Catch ce As CommunicationException
                Console.WriteLine("An exception occurred: {0}", ce.Message)
                selfHost.Abort()
            End Try
        End Sub
    End Class

End Module

有关此代码的工作原理的信息，请参阅服务承载程序步骤。

更新项目属性：
1. 在“解决方案资源管理器”窗口中选择“GettingStartedHost”文件夹，然后从快捷菜单中选择“属性”。
2. 在“GettingStartedHost”属性页上，选择“应用程序”选项卡：
  - 对于 C# 项目，请从“启动对象”列表中选择“GettingStartedHost.Program”。
  - 对于 Visual Basic 项目，请从“启动对象”列表中选择“Service.Program”。
3. 在“文件”菜单中选择“全部保存”。

验证服务是否正常运行

生成解决方案，然后在 Visual Studio 中运行“GettingStartedHost”控制台应用程序。

必须以管理员特权运行该服务。由于 Visual Studio 是以管理员特权打开的，因此在 Visual Studio 中运行“GettingStartedHost”时，应用程序也将以管理员特权运行。或者，可以管理员身份打开一个新的命令提示符（从快捷菜单中选择“更多”>“以管理员身份运行”）并在其中运行“GettingStartedHost.exe”。
打开 Web 浏览器并通过 http://localhost:8000/GettingStarted/ 浏览到服务的页面。

备注

此类服务需要拥有适当的权限，以便能够在计算机上注册 HTTP 地址以进行侦听。管理员帐户具有此权限，但对于非管理员帐户来说，必须授予对 HTTP 命名空间的权限。有关如何配置命名空间预留的详细信息，请参阅配置 HTTP 和 HTTPS。

服务承载程序步骤

下面介绍了你添加的用于承载服务的代码中的步骤：

步骤 1：创建 Uri 类的实例来保存服务的基址。包含基址的 URL 具有一个用于标识服务的可选 URI。基址的格式如下：<transport>://<machine-name or domain><:optional port #>/<optional URI segment>。计算器服务的基址使用 HTTP 传输、localhost、端口 8000 和 URI 段 GettingStarted。
步骤 2：创建 ServiceHost 类的实例用于承载服务。构造函数采用两个参数：实现服务协定的类的类型，以及服务的基址。
步骤 3：创建 ServiceEndpoint 实例。服务终结点由地址、绑定和服务协定组成。 ServiceEndpoint 构造函数由服务协定接口类型、绑定和地址构成。服务协定是在服务类型中定义和实现的 ICalculator。此示例中的绑定是 WSHttpBinding，它是一个内置绑定，将连接到符合 WS-* 规范的终结点。有关 WCF 绑定的详细信息，请参阅 WCF 绑定概述。将地址追加到基址以标识终结点。代码将地址指定为 CalculatorService，将终结点的完全限定地址指定为 http://localhost:8000/GettingStarted/CalculatorService。

重要

对于 .NET Framework 4 和更高版本，添加服务终结点是可选操作。对于这些版本，如果你未添加代码或配置，WCF 将为服务实现的基址和协定的每种组合添加一个默认终结点。有关默认终结点的详细信息，请参阅指定终结点地址。有关默认终结点、绑定和行为的详细信息，请参阅简化的配置和 WCF 服务的简化配置。
步骤 4：启用元数据交换。客户端使用元数据交换来生成用于调用服务操作的代理。若要启用元数据交换，请创建一个 ServiceMetadataBehavior 实例，将其 HttpGetEnabled 属性设置为 true，并将 ServiceMetadataBehavior 对象添加到 ServiceHost 实例的 Behaviors 集合。
步骤 5：打开 ServiceHost 以侦听传入的消息。应用程序等待你按 Enter 键。在应用程序实例化 ServiceHost 后，它将执行一个 try/catch 块。有关安全捕获 ServiceHost 引发的异常的详细信息，请参阅使用 Close 和 Abort 释放 WCF 客户端资源。

重要

添加 WCF 服务库时，如果你通过启动服务主机对其进行调试，Visual Studio 将为你承载该库。为了避免冲突，可以阻止 Visual Studio 承载 WCF 服务库。

在“解决方案资源管理器”中选择“GettingStartedLib”项目，然后从快捷菜单中选择“属性”。
选择“WCF 选项”，并取消选中“调试同一解决方案中的另一个项目时启动 WCF 服务主机”。

后续步骤

在本教程中，你了解了如何执行以下操作：

创建并配置用于承载 WCF 服务的控制台应用项目。
添加代码以承载 WCF 服务。
更新配置文件。
启动 WCF 服务并验证它是否正在运行。

请继续学习下一篇教程，了解如何创建 WCF 客户端。

教程：创建 WCF 客户端

通过