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

教程:创建 Windows Communication Foundation 客户端

· 52CE 我爱测

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

本教程介绍创建基本 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 客户端

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

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

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

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

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

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

  2. 添加引用GettingStartedClient投影到xref:System.ServiceModel程序集:

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

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

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

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

  3. 添加到计算器服务的服务引用:

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

    2. 在中添加服务引用窗口中,选择Discover。

      CalculatorService 服务启动和 Visual Studio 将显示在Services框。

    3. 选择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 服务,以生成客户端应用程序的代理类和配置文件的服务引用。

转到下一步的教程,了解如何使用生成的客户端。

教程:使用 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(示例代码)

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

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