本教程介绍创建基本 Windows Communication Foundation (WCF) 应用程序所需的五个任务的第三个。 有关教程的概述,请参阅教程:开始使用 Windows Communication Foundation 应用程序。
下一个任务创建的 WCF 应用程序是托管在一个控制台应用程序中的 WCF 服务。 WCF 服务公开一个或多个终结点,其中每个都公开一个或多个服务操作。 服务终结点指定以下信息:
- 在哪里可以找到该服务的地址。
- 一个绑定,它包含描述如何在客户端必须与服务通信的信息。
- 定义服务向其客户端提供的功能的协定。
在本教程中,你将了解:
- 创建和配置用于承载 WCF 服务的控制台应用项目。
- 添加代码以承载 WCF 服务。
- 更新配置文件。
- 启动 WCF 服务并验证其是否正在运行。
创建和配置托管服务的一个控制台应用程序项目
-
在 Visual Studio 中创建一个控制台应用程序项目:
-
从文件菜单中,选择打开 > 项目/解决方案并浏览到GettingStarted解决方案,以前创建的 (GettingStarted.sln)。 选择“打开” 。
-
从视图菜单中,选择解决方案资源管理器。
-
在中解决方案资源管理器窗口中,选择GettingStarted解决方案 (高层节点),然后选择添加 > 的新项目从快捷菜单。
-
在中添加新项目窗口中的,左侧和右侧,选择Windows Desktop类别中的下Visual C# 或Visual Basic.
-
选择控制台应用 (.NET Framework) 模板,并输入GettingStartedHost有关名称。 选择 确定。
-
-
添加引用GettingStartedHost投影到GettingStartedLib项目:
-
在中解决方案资源管理器窗口中,选择引用下的文件夹GettingStartedHost项目,,然后选择添加引用从快捷菜单。
-
在中添加引用对话框下项目在窗口的左侧,选择解决方案。
-
选择GettingStartedLib中的窗口中,并选择中心部分确定。
此操作使得中定义的类型GettingStartedLib项目可供GettingStartedHost项目。
-
-
添加引用GettingStartedHost投影到xref:System.ServiceModel程序集:
-
在中解决方案资源管理器窗口中,选择引用下的文件夹GettingStartedHost项目,,然后选择添加引用从快捷菜单。
-
在中添加引用窗口下程序集在窗口的左侧,选择Framework。
-
选择System.ServiceModel,然后选择确定。
-
通过选择保存解决方案文件 > 全部保存。
-
添加代码以承载服务
若要托管该服务,你可以添加代码以执行以下步骤:
- 创建的基址 URI。
- 创建用于承载服务的类实例。
- 创建服务终结点。
- 启用元数据交换。
- 打开服务主机以侦听传入消息。
对代码进行以下更改:
-
打开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有关此代码的工作方式的信息,请参阅服务托管计划步骤。
-
更新项目属性:
-
在中解决方案资源管理器窗口中,选择GettingStartedHost文件夹,,然后选择属性从快捷菜单。
-
上GettingStartedHost属性页上,选择应用程序选项卡:
-
有关C#项目中,选择GettingStartedHost.Program从启动对象列表。
-
对于 Visual Basic 项目中,选择Service.Program从启动对象列表。
-
-
从文件菜单中,选择全部保存。
-
验证服务正常工作
-
构建解决方案,然后运行GettingStartedHost控制台应用程序从 Visual Studio 内部。
必须使用管理员特权运行服务。 因为在运行时使用管理员特权打开 Visual Studio GettingStartedHost在 Visual Studio 中,应用程序运行使用管理员的权限。 或者,可以打开新的命令提示符以管理员身份 (选择更多 > 以管理员身份运行从快捷菜单) 并运行GettingStartedHost.exe其内。
-
打开 web 浏览器并浏览到服务的页面在
http://localhost:8000/GettingStarted/CalculatorService。NOTE 此类服务需要适当的权限来为要侦听的计算机上注册 HTTP 地址。 管理员帐户具有此权限,但对于非管理员帐户来说,必须授予对 HTTP 命名空间的权限。 有关如何配置命名空间预留的详细信息,请参阅配置 HTTP 和 HTTPS。
服务宿主程序步骤
添加到主机服务进行了介绍,如下所示的代码中的步骤:
-
步骤 1:创建的实例
Uri类来保存服务的基址。 包含一个基址的 URL 采用一个可选 URI,这标识服务。 基址的格式如下:<transport>://<machine-name or domain><:optional port #>/<optional URI segment>。 计算器服务的基址使用 HTTP 传输协议、 本地主机、 端口 8000 和 URI 段,GettingStarted。 -
步骤 2:创建的实例xref:System.ServiceModel.ServiceHost类,该类用于承载服务。 构造函数采用两个参数: 实现服务协定和服务的基址的类的类型。
-
步骤 3:创建一个 xref:System.ServiceModel.Description.ServiceEndpoint 实例。 服务终结点由地址、绑定和服务协定组成。 xref:System.ServiceModel.Description.ServiceEndpoint构造函数组成的服务协定接口类型、 绑定和地址。 服务协定是在服务类型中定义和实现的
ICalculator。 为此示例绑定是xref:System.ServiceModel.WSHttpBinding,这是一个内置的绑定和连接到终结点符合 WS-* 规范。 有关 WCF 绑定的详细信息,请参阅WCF 绑定概述。 将追加到基址以标识终结点的地址。 该代码指定的地址作为 CalculatorService 和作为终结点的完全限定的地址http://localhost:8000/GettingStarted/CalculatorService。IMPORTANT 针对.NET Framework 版本 4 及更高版本,添加服务终结点是可选的。 对于这些版本,如果您没有添加您的代码或配置中,WCF 将添加一个默认终结点的基址和协定,该服务实现的每个组合。 有关默认终结点的详细信息,请参阅指定的终结点地址。 有关默认终结点、 绑定和行为的详细信息,请参阅简化后的配置并WCF 服务的简化配置。
-
步骤 4:启用元数据交换。 客户端使用元数据交换来调用服务操作的生成代理。 若要启用元数据交换,创建xref:System.ServiceModel.Description.ServiceMetadataBehavior实例,设置其xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpGetEnabled属性设置为
true,并添加ServiceMetadataBehavior对象传递给xref:System.ServiceModel.Description.ServiceDescription.Behaviors*系列xref:System.ServiceModel.ServiceHost实例。 -
步骤 5:打开xref:System.ServiceModel.ServiceHost侦听传入消息。 应用程序等待用户按Enter。 应用程序实例化后xref:System.ServiceModel.ServiceHost,它将执行 try/catch 块。 有关安全捕获引发的异常详细信息xref:System.ServiceModel.ServiceHost,请参阅使用关闭和中止发布 WCF 客户端资源。
Important: 当添加 WCF 服务库时,Visual Studio 承载它为您如果调试通过启动服务主机。 若要避免冲突,您可防止 Visual Studio 承载 WCF 服务库。
- 选择GettingStartedLib项目中解决方案资源管理器,然后选择属性从快捷菜单。
- 选择WCF 选项并取消选中启动 WCF 服务主机在调试同一解决方案中的另一个项目时。
后续步骤
在本教程中,你将了解:
- 创建和配置用于承载 WCF 服务的控制台应用项目。
- 添加代码以承载 WCF 服务。
- 更新配置文件。
- 启动 WCF 服务并验证其是否正在运行。
转到下一步的教程,了解如何创建 WCF 客户端。
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
