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

教程:定义 Windows Communication Foundation 服务协定

· 52CE 我爱测

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

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

创建 WCF 服务时,您的首要任务是定义服务协定。 服务协定指定服务支持的操作。 可以将操作视为一个 Web 服务方法。 通过定义视觉对象创建服务协定C#或 Visual Basic (VB) 接口。 接口具有以下特征:

在本教程中,你将了解:

  • 创建WCF 服务库项目。
  • 定义服务协定接口。

创建 WCF 服务库项目并定义服务协定接口

  1. 以管理员身份打开 Visual Studio。 若要执行此操作,请选择中的 Visual Studio 程序启动菜单,并选择详细 > 以管理员身份运行从快捷菜单。

  2. 创建WCF 服务库项目。

    1. 从“文件”菜单中选择“新建” > “项目”。

    2. 在中新的项目对话框中的,在左侧,展开Visual C# 或Visual Basic,然后选择WCF类别。 Visual Studio 窗口的中心部分中显示项目模板的列表。 选择WCF 服务库。

      NOTE 如果没有看到WCF项目模板类别中,您可能需要安装Windows Communication Foundation组件的 Visual Studio。 在中新的项目对话框中,选择打开 Visual Studio 安装程序左侧和右侧的链接。 选择各个组件选项卡,然后找到并选择Windows Communication Foundation下开发活动类别。 选择修改以开始安装该组件。

    3. 在窗口的下半部分中,输入GettingStartedLib有关名称并GettingStarted有关解决方案名称。

    4. 选择 确定。

      Visual Studio 创建项目,它具有三个文件:IService1.cs (或IService1.vb Visual Basic 项目), Service1.cs (或Service1.vb Visual Basic 项目),和App.config。Visual Studio 定义这些文件,如下所示:

      • IService1文件包含服务协定的默认定义。
      • Service1文件包含服务协定的默认实现。
      • App.config文件包含加载具有 Visual Studio WCF 服务主机工具的默认服务所需的配置信息。 有关 WCF 服务主机工具的详细信息,请参阅WCF 服务主机 (WcfSvcHost.exe)。

      NOTE 如果使用 Visual Basic 开发人员环境设置安装 Visual Studio,解决方案可能被隐藏。 如果这种情况,请选择选项从工具菜单中,然后选择项目和解决方案 > 常规中选项窗口。 选择总是显示解决方案。 此外,检查是否保存新项目时创建处于选中状态。

  3. 从解决方案资源管理器,打开IService1.cs或IService1.vb文件,并其代码替换为以下代码:

    using System;
    using System.ServiceModel;
    
    namespace GettingStartedLib
    {
            [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
            public interface ICalculator
            {
                [OperationContract]
                double Add(double n1, double n2);
                [OperationContract]
                double Subtract(double n1, double n2);
                [OperationContract]
                double Multiply(double n1, double n2);
                [OperationContract]
                double Divide(double n1, double n2);
            }
    }
    
    Imports System.ServiceModel
    
    Namespace GettingStartedLib
    
        <ServiceContract(Namespace:="http://Microsoft.ServiceModel.Samples")> _
        Public Interface ICalculator
    
            <OperationContract()> _
            Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
            <OperationContract()> _
            Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
            <OperationContract()> _
            Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
            <OperationContract()> _
            Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
        End Interface
    End Namespace
    

    本协定定义了一个在线计算器。 请注意ICalculator接口将标有xref:System.ServiceModel.ServiceContractAttribute属性 (为简化ServiceContract)。 此属性定义一个命名空间以消除协定名称的歧义。 该代码将标记与每个计算器操作xref:System.ServiceModel.OperationContractAttribute属性 (为简化OperationContract)。

后续步骤

在本教程中,你将了解:

  • 创建 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(示例代码)

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

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