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

如何:在 ASP.NET AJAX 终结点的 HTTP POST 和 HTTP GET 请求之间进行选择

· 52CE 我爱测

Windows Communication Foundation (WCF) 可以创建公开支持 ASP.NET AJAX 的终结点在客户端网站上可从 JavaScript 中调用的服务。 中介绍了用于构建此类服务的基本过程如何:使用配置来添加 ASP.NET AJAX 终结点和如何:添加 ASP.NET AJAX 终结点而不使用配置。

Windows Communication Foundation (WCF) 可以创建公开支持 ASP.NET AJAX 的终结点在客户端网站上可从 JavaScript 中调用的服务。 中介绍了用于构建此类服务的基本过程如何:使用配置来添加 ASP.NET AJAX 终结点和如何:添加 ASP.NET AJAX 终结点而不使用配置。

ASP.NET AJAX 支持使用 HTTP POST 和 HTTP GET 谓词(HTTP POST 为默认谓词)的操作。 创建没有任何副作用并返回很少或从不进行更改的数据的操作时,应改用 HTTP GET。 GET 操作的结果可以缓存,这意味着对相同操作的多次调用可能导致只请求一次服务。 缓存不是由 WCF,但可以发生在任何级别 (用户的浏览器中,代理服务器和其他级别上。)如果要提高服务性能,则使用缓存会比较有利,但在数据频繁更改或操作执行某些动作时可能不可行。

例如,如果设计服务来管理用户的音乐库,则基于唱片集的标题查找艺术家的操作可以从使用 GET 中获益,但是将唱片集添加到用户的个人收藏集的操作必须使用 POST。

若要控制缓存的生存期,请使用 xref:System.ServiceModel.Web.OutgoingWebResponseContext 类型。 例如,在设计返回每小时更新的天气预报时会使用 GET,但应将缓存持续时间限制在一小时以内,以防止服务的用户访问过时的数据。

在使用来自使用脚本管理器控件的 ASP.NET AJAX 页上的服务时,操作是使用 GET 还是 POST 并没有区别,脚本管理器机制会确保发出正确的请求类型。

HTTP GET 操作使用由 POST 操作支持的任何输入参数,其中包括复杂的数据协定类型。 但是,大多数情况下建议避免在 GET 操作中使用太多的参数或太复杂的参数,原因是这样会降低缓存的效率。

本主题演示了如何通过在服务协定中将 xref:System.ServiceModel.Web.WebGetAttribute 或 xref:System.ServiceModel.Web.WebInvokeAttribute 属性添加到相关的操作以在 GET 和 POST 之间选择。 类似于所使用的 WCF 中的任何 ASP.NET AJAX 服务的其他步骤 (实现、 配置和承载服务) 所需运行此服务。

以 xref:System.ServiceModel.Web.WebGetAttribute 标记的操作始终使用 GET 请求。 以 xref:System.ServiceModel.Web.WebInvokeAttribute 标记或未以这两个属性中的任何一个进行标记的操作将使用 POST 请求。 通过 xref:System.ServiceModel.Web.WebInvokeAttribute 属性,xref:System.ServiceModel.Web.WebInvokeAttribute.Method* 允许使用 GET 和 POST 之外的其他 HTTP 谓词(如 PUT 和 DELETE 等)。 但是,ASP.NET AJAX 不支持这些谓词。 如果打算使用脚本管理器控件来使用来自 ASP.NET 页上的服务,请不要使用 xref:System.ServiceModel.Web.WebInvokeAttribute.Method* 属性。

切换到 GET 的工作示例,请参阅基本 AJAX 服务示例。

使用 POST 的示例,请参阅使用 HTTP POST 的 AJAX 服务示例。

创建响应 HTTP GET 或 HTTP POST 请求的 WCF 服务

  1. 使用标记的接口定义基本的 WCF 服务约定xref:System.ServiceModel.ServiceContractAttribute属性。 用 xref:System.ServiceModel.OperationContractAttribute 标记每个操作。 添加 xref:System.ServiceModel.Web.WebGetAttribute 属性以规定操作应响应 HTTP GET 请求。 也可以添加 xref:System.ServiceModel.Web.WebInvokeAttribute 属性来显式指定 HTTP POST,或不指定属性(默认设置为 HTTP POST)。

    [ServiceContract]  
    public interface IMusicService  
    {  
        //This operation uses a GET method.  
        [OperationContract]  
        [WebGet]  
        string LookUpArtist(string album);  
    
        //This operation will use a POST method.  
        [OperationContract]  
        [WebInvoke]  
        void AddAlbum(string user, string album);  
    
        //This operation will use POST method by default  
        //since nothing else is explicitly specified.  
        [OperationContract]  
        string[] GetAlbums(string user);  
    
        //Other operations omitted…  
    
    }  
    
  2. 使用 IMusicService 实现 MusicService 服务协定。

    public class MusicService : IMusicService  
    {  
        public void AddAlbum(string user, string album)  
        {  
            //Add implementation here.  
        }  
    
         //Other operations omitted…  
    }  
    
  3. 在应用程序中创建一个名为 service 的新文件(扩展名为 .svc)。 编辑此文件添加适当的 @ServiceHost服务指令信息。 指定的xref:System.ServiceModel.Activation.WebScriptServiceHostFactory是要在中使用 @ServiceHost指令以自动配置 ASP.NET AJAX 终结点。

    <%@ServiceHost   
        language=c#   
        Debug="true"   
        Service="Microsoft.Ajax.Samples.MusicService"  
        Factory=System.ServiceModel.Activation.WebScriptServiceHostFactory  
    %>  
    

调用服务

  1. 可以通过使用浏览器来测试服务的 GET 操作,而无需使用任何客户端代码。 例如,如果你的服务配置在http://example.com/service.svc地址,然后键入http://example.com/service.svc/LookUpArtist?album=SomeAlbum到浏览器地址栏调用该服务,并使响应可以下载或显示。

  2. 可以像使用任何其他 ASP.NET AJAX 服务一样将服务与 GET 操作一起使用,即,在 ASP.NET AJAX 脚本管理器控件的“脚本”集合中输入相应的服务 URL。 有关示例,请参阅基本 AJAX 服务。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

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

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