本教程介绍创建基本 Windows Communication Foundation (WCF) 应用程序所需的五个任务的第一个。 有关教程的概述,请参阅教程:开始使用 Windows Communication Foundation 应用程序。
创建 WCF 服务时,您的首要任务是定义服务协定。 服务协定指定服务支持的操作。 可以将操作视为一个 Web 服务方法。 通过定义视觉对象创建服务协定C#或 Visual Basic (VB) 接口。 接口具有以下特征:
- 接口中的每个方法都对应于特定的服务操作。
- 对于每个接口,你必须应用xref:System.ServiceModel.ServiceContractAttribute属性。
- 对于每个操作/方法,你必须应用xref:System.ServiceModel.OperationContractAttribute属性。
在本教程中,你将了解:
- 创建WCF 服务库项目。
- 定义服务协定接口。
创建 WCF 服务库项目并定义服务协定接口
-
以管理员身份打开 Visual Studio。 若要执行此操作,请选择中的 Visual Studio 程序启动菜单,并选择详细 > 以管理员身份运行从快捷菜单。
-
创建WCF 服务库项目。
-
从“文件”菜单中选择“新建” > “项目”。
-
在中新的项目对话框中的,在左侧,展开Visual C# 或Visual Basic,然后选择WCF类别。 Visual Studio 窗口的中心部分中显示项目模板的列表。 选择WCF 服务库。
NOTE 如果没有看到WCF项目模板类别中,您可能需要安装Windows Communication Foundation组件的 Visual Studio。 在中新的项目对话框中,选择打开 Visual Studio 安装程序左侧和右侧的链接。 选择各个组件选项卡,然后找到并选择Windows Communication Foundation下开发活动类别。 选择修改以开始安装该组件。
-
在窗口的下半部分中,输入GettingStartedLib有关名称并GettingStarted有关解决方案名称。
-
选择 确定。
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,解决方案可能被隐藏。 如果这种情况,请选择选项从工具菜单中,然后选择项目和解决方案 > 常规中选项窗口。 选择总是显示解决方案。 此外,检查是否保存新项目时创建处于选中状态。
-
-
从解决方案资源管理器,打开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 服务约定。
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
