WCF技术

定义 Windows Communication Foundation 服务协定

时间:2014-4-14 15:38:46  作者:WPF之家  来源:http://www.wpf123.com/  查看:1135  评论:0
内容摘要:创建基本 WCF 服务时,第一项任务是定义协定。协定指定服务支持的操作。可以将操作视为一个 Web 服务方法。通过定义 C++、C# 或 Visual Basic (VB) 接口可创建协定。接口中的每个方法都对应于特定的服务操作。每个接口都必须将 ServiceContractA...
创建基本 WCF 服务时,第一项任务是定义协定。协定指定服务支持的操作。可以将操作视为一个 Web 服务方法。通过定义 C++、C# 或 Visual Basic (VB) 接口可创建协定。接口中的每个方法都对应于特定的服务操作。每个接口都必须将 ServiceContractAttribute 应用于自身,而每个操作都必须将 OperationContractAttribute 应用于自身。如果接口中的一个方法具有 ServiceContractAttribute 而没有 OperationContractAttribute,则不公开该方法。

在操作过程后面的示例中提供了用于此任务的代码。

使用接口创建 Windows Communication Foundation 协定
通过在 “开始”菜单中右击“Visual Studio 2010”并选择 “以管理员身份运行”,以管理员身份打开该程序。

创建新的控制台应用程序项目。单击 “文件”菜单,选择 “新建”,然后选择 “项目”。在 “新建项目”对话框中,选择 “Visual Basic”或 “Visual C#”,选择 “控制台应用程序”模板,然后将其命名为 Service。使用默认的 “位置”。

对于 C# 项目,Visual Studio 会创建名为 Program.cs 的文件。此类会包含名为 Main() 的空方法。对于 VB 项目,Visual Studio 会创建名为 Module1.vb 的文件,其中包含名为 Main() 的空子例程。控制台应用程序项目需要这些方法才能正确生成,因此您可以放心地将这些方法保留在项目中。

将默认的 Service 命名空间更改为 Microsoft.ServiceModel.Samples。为此,请在 “解决方案资源管理器”中,右击项目,并选择 “属性”。确保选择了 “属性”对话框左侧的 “应用程序”选项卡。对于 C# 项目,在标有 “默认命名空间”的编辑框中键入 Microsoft.ServiceModel.Samples。对于 VB 项目,在标有 “根命名空间”的编辑框中键入 Microsoft.ServiceModel.Samples。单击 “文件”菜单,然后选择 “全部保存”以保存更改。

如果使用 C#,请在生成的 Program.cs 文件中将命名空间更改为 Microsoft.ServiceModel.Samples,如下面的示例所示。

namespace Microsoft.ServiceModel.Samples 
{
    class Program
    {
        static void Main(string[] args)
        {
        }
    }
}

将对 System.ServiceModel.dll 的引用添加到项目:

在 “解决方案资源管理器”中,右击项目文件夹下的 “引用”文件夹,然后选择 “添加引用”。 


在 “添加引用”对话框中选择 “.NET”选项卡,向下滚动屏幕,看到 “System.ServiceModel”(版本 4.0.0.0)后,将其选中,然后单击 “确定”。 


在使用命令行编译器(例如 Csc.exe 或 Vbc.exe)时,还必须提供程序集的路径。例如,默认情况下,在运行 Windows Vista 的计算机上,路径为:“Windows\Microsoft.NET\Framework\v4.0”。 

为 System.ServiceModel 命名空间添加一个 using 语句(在 Visual Basic 中为 Imports)。
using System.ServiceModel;


定义一个名为 ICalculator 的新接口,并向该接口应用 Namespace 值为“http://Microsoft.ServiceModel.Samples”的 ServiceContractAttribute 特性。显式指定命名空间是一种最佳做法,因为这样可防止将默认命名空间值添加到协定名称。

ms731835.note(zh-cn,VS.100).gif注意: 
使用特性给接口或类添加批注时,可以从特性名称中去掉“Attribute”部分。因此 ServiceContractAttribute 在 C# 中为 [ServiceContract],在 Visual Basic 中为 <ServiceContract>。 

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
public interface ICalculator


在接口中为 ICalculator 协定公开的每个操作(加、减、乘和除)声明一个方法,并对希望作为公共 WCF 协定的一部分公开的每个方法应用 OperationContractAttribute 特性。

[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);

示例
下面的代码示例演示一个定义服务协定的基本接口。

using System;
// Step 5: Add the using statement for the System.ServiceModel namespace
using System.ServiceModel;
namespace Microsoft.ServiceModel.Samples
{
  // Step 6: Define a service contract.
  [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
  public interface ICalculator
  {
    // Step7: Create the method declaration for the contract.
    [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);
  }
}

现在已创建接口,继续按照 如何:实现 Windows Communication Foundation 服务协定中的说明实现该接口。


标签:定义 服务 协定 

原创作品,允许转载,转载时请务必以超链接形式标明文章 原始出处 、作者信息和本声明。否则将追究法律责任。本文出自“wpf之家”,请务必保留此出处:http://www.wpf123.com

相关评论
Copyright © 2009-2014 WPF之家(http://www.wpf123.com/) All rights reserved
 Powered by WPF之家
鄂ICP备13006396号