WCF Visual Studio 模板
Windows Communication Foundation (WCF) Visual Studio 模板是预定义的项目和项模板,可在 Visual Studio 中用于快速生成 WCF 服务和周边应用程序。
使用 WCF 模板
WCF Visual Studio 模板为服务开发提供基本的类结构。具体地说,这些模板提供服务协定、数据协定、服务实现和配置的基本定义。可以使用这些模板创建代码交互最少的简单服务以及更高级的服务的构造块。
WCF 服务库项目模板
在**“Visual C#\WCF”和“Visual Basic\WCF”**下面的新建项目对话框中可以使用 WCF 服务库项目模板。
使用**“WCF 服务”**模板创建新项目时,新项目将自动包括以下三个文件:
- 服务协定文件(IService1.cs 或 IService1.vb)。服务协定文件是一个应用了 WCF 服务属性的接口。此文件提供简单服务的定义以表明如何定义服务,并且包括基于参数的操作和简单的数据协定示例。这是创建 WCF 服务项目之后在代码编辑器中显示的默认文件。
- 服务实现文件(Service1.cs 或 Service1.vb)。服务实现文件实现服务协定文件中定义的协定。
- 应用程序配置文件 (App.config)。该配置文件为 WCF 服务模型的基本元素提供安全的 HTTP 绑定。它还包括一个服务终结点,并启用了元数据交换。
注意:Visual Studio 被配置为在使用 WCF 服务主机 (WcfSvcHost.exe)运行项目时将 App.config 文件识别为该项目的配置文件,这是默认配置。如果将服务库承载于可执行文件中,则必须将配置代码移动到可执行文件的配置文件中,因为 DLL 的配置文件无效。
WCF Web 应用程序服务模板
“新建项目”对话框中的**“Visual C#\Web”和“Visual Basic\Web”**下面提供了 WCF Web 应用程序服务模板。
使用**“WCF Web 应用程序服务”**模板创建新项目时,该项目将包括以下四个文件:
- 服务主机文件 (service1.svc)
- 服务协定文件(IService1.cs 或 IService1.vb)
- 服务实现文件(Service1.svc.cs 或 Service1.svc.vb)
- Web 配置文件 (web.config)
此模板将自动创建一个网站(该网站将要部署到虚拟目录),并在该网站中承载服务。
WCF 网站模板
“新建项目”对话框中的**“Visual C#\网站\WCF 服务”和“Visual Basic\网站\WCF 服务”**下面提供了 WCF 网站模板。
WCF 服务项模板
WCF 服务项模板是一个自定义模板,通过该模板可以快速将 WCF 服务添加到现有的 Visual Studio 项目。
若要使用此模板,请转到**“解决方案资源管理器”窗格,右击项目名称,指向“添加”,然后单击“新建项”以启动“添加新项目”**对话框。
服务接口和实现文件放在根项目文件夹中。
该模板尝试将新服务的配置节合并到兼容类型的现有配置文件中。
如果现有项目是 Web 项目,则也会创建服务主机文件 (service1.svc)。
WCF WF 服务项目和项模板。
这些模板将创建承载工作流服务的 WCF 服务,工作流服务是可像 Web 服务那样被访问的工作流。XAML 或命令式编程模型具有单独的模板。通过使用模板,可以创建顺序工作流或状态机工作流。有关这些类型的工作流的更多信息,请参见 Windows Workflow Foundation Tutorials。有关创建工作流项目的更多信息,请参见Creating Workflow Projects。
当使用 XOML 类型的工作流来代替基于代码的工作流时,Visual Studio 设计器的响应能力较强。XOML 工作流是要创建的默认工作流类型。
WCF 联合模板
通过使用此模板,可以将 RSS 或 ATOM 格式的源作为 WCF 服务公开。有关更多信息,请参见 WCF Syndication。
更改源的地址
在执行期间,联合模板使用 Internet Explorer。当在 Visual Studio 的**“解决方案资源管理器”中右击您的项目,选择“属性”,然后选择“调试”**选项卡之后,将看到模板的默认地址。Internet Explorer 将尝试打开位于此地址的源。
如果更改源的地址,则还必须更改**“调试”**选项卡中的地址。如果未执行此操作,则 Internet Explorer 将尝试打开位于默认地址的源,并会失败。
支持 AJAX 的 WCF 服务项模板
此模板将 AJAX 控件作为 WCF 服务公开。有关 AJAX 控件的更多信息,请参阅 AJAX 控件文档(可能为英文网页)。
启用了 Silverlight 的 WCF 服务项模板
该模板创建提供数据给 Silverlight 客户端或前端的 Web 服务。可以将该模板添加到网站或 Web 应用程序项目中,以创建 WCF 服务,其中包括支持与 Silverlight 客户端进行通信的服务代码和配置。然后可以使用**“添加服务引用”**将该服务的客户端代理添加到此客户端,之后即可在 Silverlight 客户端与启用了 Silverlight 的 WCF 服务之间交换数据。
若要访问此模板,请在**“解决方案资源管理器”中右击某个网站或 Web 应用程序项目,然后依次单击“添加新项”和“启用了 Silverlight 的 WCF 服务”**。
警告 启用了 Silverlight 的 WCF 服务会公开 basicHttpBinding 终结点,而不启用任何安全设置。因此,连接到此服务的任何客户端都可以获取有关此服务的信息。此外,在该服务与客户端之间交换的消息也未经过签名和加密处理。若要正确保护该终结点,应使用 ASP.NET 身份验证、https 或其他机制。
另请参见
概念
WCF 服务主机 (WcfSvcHost.exe)
WCF 测试客户端 (WcfTestClient.exe)
版权所有 (C) 2007 Microsoft Corporation。保留所有权利。