本教程介绍创建基本 Windows Communication Foundation (WCF) 应用程序所需的五个任务的第四个。 有关教程的概述,请参阅教程:开始使用 Windows Communication Foundation 应用程序。
创建 WCF 应用程序的下一个任务是通过从 WCF 服务检索元数据创建客户端。 使用 Visual Studio 添加服务引用,它将从服务的 MEX 终结点获取元数据。 Visual Studio 然后为你选择的语言中的客户端代理生成托管的源代码文件。 它还会创建客户端配置文件 (App.config)。 此文件使客户端应用程序连接到终结点的服务。
Note: 如果从一个在 Visual Studio 类库项目调用 WCF 服务,使用添加服务引用功能来自动生成代理和关联的配置文件。 但是,因为在类库项目不使用此配置文件,您需要在生成的配置文件中添加设置App.config调用该类库的可执行文件的文件。
Note: 或者,使用ServiceModel 元数据实用工具工具而不是 Visual Studio 生成代理类和配置文件。
客户端应用程序使用生成的代理类与服务通信。 此过程所述教程:使用客户端。
在本教程中,你将了解:
- 创建和配置 WCF 客户端的控制台应用程序项目。
- 添加到 WCF 服务生成代理类和配置文件的服务引用。
创建 Windows Communication Foundation 客户端
-
在 Visual Studio 中创建一个控制台应用程序项目:
-
从文件菜单中,选择打开 > 项目/解决方案并浏览到GettingStarted解决方案,以前创建的 (GettingStarted.sln)。 选择“打开” 。
-
从视图菜单中,选择解决方案资源管理器。
-
在中解决方案资源管理器窗口中,选择GettingStarted解决方案 (高层节点),然后选择添加 > 的新项目从快捷菜单。
-
在中添加新项目窗口中的,左侧和右侧,选择Windows Desktop类别中的下Visual C# 或Visual Basic.
-
选择控制台应用 (.NET Framework) 模板,并输入GettingStartedClient有关名称。 选择 确定。
-
-
添加引用GettingStartedClient投影到xref:System.ServiceModel程序集:
-
在中解决方案资源管理器窗口中,选择引用下的文件夹GettingStartedClient项目,,然后选择添加引用从快捷菜单。
-
在中添加引用窗口下程序集在窗口的左侧,选择Framework。
-
找到并选择System.ServiceModel,然后选择确定。
-
通过选择保存解决方案文件 > 全部保存。
-
-
添加到计算器服务的服务引用:
-
在中解决方案资源管理器窗口中,选择引用下的文件夹GettingStartedClient项目,,然后选择添加服务引用从快捷菜单。
-
在中添加服务引用窗口中,选择Discover。
CalculatorService 服务启动和 Visual Studio 将显示在Services框。
-
选择CalculatorService以将其展开并显示由该服务实现的服务协定。 保留默认值Namespace ,然后选择确定。
Visual Studio 会添加新项下的连接的服务中的文件夹GettingStartedClient项目。
-
ServiceModel 元数据实用工具工具
下面的示例演示如何根据需要使用ServiceModel 元数据实用工具工具 (Svcutil.exe)生成代理类文件。 此工具生成代理类文件和App.config文件。 以下示例演示如何生成中的代理C#和 Visual Basic 中,分别:
svcutil.exe /language:cs /out:generatedProxy.cs /config:app.config http://localhost:8000/GettingStarted/CalculatorService
svcutil.exe /language:vb /out:generatedProxy.vb /config:app.config http://localhost:8000/GettingStarted/CalculatorService
客户端配置文件
创建客户端后,Visual Studio 将创建App.config中的配置文件GettingStartedClient项目,它应类似于下面的示例:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<startup>
<!-- specifies the version of WCF to use-->
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1" />
</startup>
<system.serviceModel>
<bindings>
<!-- Uses wsHttpBinding-->
<wsHttpBinding>
<binding name="WSHttpBinding_ICalculator" />
</wsHttpBinding>
</bindings>
<client>
<!-- specifies the endpoint to use when calling the service -->
<endpoint address="http://localhost:8000/GettingStarted/CalculatorService"
binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_ICalculator"
contract="ServiceReference1.ICalculator" name="WSHttpBinding_ICalculator">
<identity>
<dns value="localhost" />
</identity>
</endpoint>
</client>
</system.serviceModel>
</configuration>
下 <system.serviceModel >部分中,请注意<终结点 >元素。 <终结点> 元素定义的终结点的客户端用于访问该服务,如下所示:
- 地址:
http://localhost:8000/GettingStarted/CalculatorService。 终结点的地址。 - 服务协定:
ServiceReference1.ICalculator。 服务协定处理 WCF 客户端和服务之间的通信。 在使用时,visual Studio 将生成此协定及其添加服务引用函数。 它是约定的实质上是约定的在 GettingStartedLib 项目中定义的副本。 - 绑定: xref:System.ServiceModel.WSHttpBinding。 绑定指定 HTTP 作为传输协议、 可互操作安全性和其他配置详细信息。
后续步骤
在本教程中,你将了解:
- 创建和配置 WCF 客户端的控制台应用程序项目。
- 添加到 WCF 服务,以生成客户端应用程序的代理类和配置文件的服务引用。
转到下一步的教程,了解如何使用生成的客户端。
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
