大网数据广告活动
.NET 与 C# 开发

教程:托管并运行基本的 Windows Communication Foundation 服务

· 52CE 我爱测

本教程介绍创建基本 Windows Communication Foundation (WCF) 应用程序所需的五个任务的第三个。 有关教程的概述,请参阅教程:开始使用 Windows Communication Foundation 应用程序。

本教程介绍创建基本 Windows Communication Foundation (WCF) 应用程序所需的五个任务的第三个。 有关教程的概述,请参阅教程:开始使用 Windows Communication Foundation 应用程序。

下一个任务创建的 WCF 应用程序是托管在一个控制台应用程序中的 WCF 服务。 WCF 服务公开一个或多个终结点,其中每个都公开一个或多个服务操作。 服务终结点指定以下信息:

  • 在哪里可以找到该服务的地址。
  • 一个绑定,它包含描述如何在客户端必须与服务通信的信息。
  • 定义服务向其客户端提供的功能的协定。

在本教程中,你将了解:

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

创建和配置托管服务的一个控制台应用程序项目

  1. 在 Visual Studio 中创建一个控制台应用程序项目:

    1. 从文件菜单中,选择打开 > 项目/解决方案并浏览到GettingStarted解决方案,以前创建的 (GettingStarted.sln)。 选择“打开” 。

    2. 从视图菜单中,选择解决方案资源管理器。

    3. 在中解决方案资源管理器窗口中,选择GettingStarted解决方案 (高层节点),然后选择添加 > 的新项目从快捷菜单。

    4. 在中添加新项目窗口中的,左侧和右侧,选择Windows Desktop类别中的下Visual C# 或Visual Basic.

    5. 选择控制台应用 (.NET Framework) 模板,并输入GettingStartedHost有关名称。 选择 确定。

  2. 添加引用GettingStartedHost投影到GettingStartedLib项目:

    1. 在中解决方案资源管理器窗口中,选择引用下的文件夹GettingStartedHost项目,,然后选择添加引用从快捷菜单。

    2. 在中添加引用对话框下项目在窗口的左侧,选择解决方案。

    3. 选择GettingStartedLib中的窗口中,并选择中心部分确定。

      此操作使得中定义的类型GettingStartedLib项目可供GettingStartedHost项目。

  3. 添加引用GettingStartedHost投影到xref:System.ServiceModel程序集:

    1. 在中解决方案资源管理器窗口中,选择引用下的文件夹GettingStartedHost项目,,然后选择添加引用从快捷菜单。

    2. 在中添加引用窗口下程序集在窗口的左侧,选择Framework。

    3. 选择System.ServiceModel,然后选择确定。

    4. 通过选择保存解决方案文件 > 全部保存。

添加代码以承载服务

若要托管该服务,你可以添加代码以执行以下步骤:

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

对代码进行以下更改:

  1. 打开Program.cs或Module1.vb文件中GettingStartedHost项目,其代码替换为以下代码:

    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
    

    有关此代码的工作方式的信息,请参阅服务托管计划步骤。

  2. 更新项目属性:

    1. 在中解决方案资源管理器窗口中,选择GettingStartedHost文件夹,,然后选择属性从快捷菜单。

    2. 上GettingStartedHost属性页上,选择应用程序选项卡:

      • 有关C#项目中,选择GettingStartedHost.Program从启动对象列表。

      • 对于 Visual Basic 项目中,选择Service.Program从启动对象列表。

    3. 从文件菜单中,选择全部保存。

验证服务正常工作

  1. 构建解决方案,然后运行GettingStartedHost控制台应用程序从 Visual Studio 内部。

    必须使用管理员特权运行服务。 因为在运行时使用管理员特权打开 Visual Studio GettingStartedHost在 Visual Studio 中,应用程序运行使用管理员的权限。 或者,可以打开新的命令提示符以管理员身份 (选择更多 > 以管理员身份运行从快捷菜单) 并运行GettingStartedHost.exe其内。

  2. 打开 web 浏览器并浏览到服务的页面在http://localhost:8000/GettingStarted/CalculatorService。

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

服务宿主程序步骤

添加到主机服务进行了介绍,如下所示的代码中的步骤:

Important: 当添加 WCF 服务库时,Visual Studio 承载它为您如果调试通过启动服务主机。 若要避免冲突,您可防止 Visual Studio 承载 WCF 服务库。

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

后续步骤

在本教程中,你将了解:

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

转到下一步的教程,了解如何创建 WCF 客户端。

教程:创建 WCF 客户端

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/19/2019
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。