WebScriptEnablingBehavior 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供对Windows Communication Foundation(WCF)终结点从基于浏览器 ASP.NET AJAX 客户端接收 HTTP 请求的行为的支持。 此类不能被继承。
public ref class WebScriptEnablingBehavior sealed : System::ServiceModel::Description::WebHttpBehavior
public sealed class WebScriptEnablingBehavior : System.ServiceModel.Description.WebHttpBehavior
type WebScriptEnablingBehavior = class
inherit WebHttpBehavior
Public NotInheritable Class WebScriptEnablingBehavior
Inherits WebHttpBehavior
- 继承
注解
应用于终结点时,WebScriptEnablingBehavior行为启用 WCF 和 ASP.NET AJAX 集成,但 JavaScript 对象表示法(JSON)编码所需的支持除外。 各种类型的编码(包括 JSON)由 WebMessageEncodingElement 适当配置或适当配置 WebHttpBinding来启用。 该 WebScriptEnablingBehavior 行为实现 IEndpointBehavior 并继承自 WebHttpBehavior该模型,从而为公开非 SOAP 终结点的 WCF 服务启用更常规的 Web 编程模型。
具体而言,是 WebScriptEnablingBehavior:
启用 HTTP 编程模型,包括根据 URL 后缀调度到操作、支持 HTTP 谓词选择(POST 或 GET)和 HTTP 缓存持续时间控制。 有关 HTTP 编程模型的详细信息,请参阅 WCF Web HTTP 编程模型概述。 请注意,使用此行为时,默认 HTTP 谓词为 POST。
为每个操作的请求和响应消息启用正确的格式化程序 - 例如,支持 URL 参数。
启用 JavaScript 代理终结点。
若要从 ASP.NET AJAX 客户端调用 WCF 服务,必须使用 WebHttpBinding 绑定配置服务,并且必须将 WebScriptEnablingBehavior 添加到终结点行为集合。 可以通过在配置中添加WebScriptEnablingElement或使用配置来完成此操作,方法是使用 .svc 文件中WebScriptServiceHostFactory 指令中的默认工厂来激活 AJAX 终结点,而不是默认工厂。
有关使 WCF 服务能够响应 ASP.NET AJAX 客户端的不同方法的详细信息,请参阅 Creating WCF Services for ASP.NET AJAX。
构造函数
| 名称 | 说明 |
|---|---|
| WebScriptEnablingBehavior() |
初始化 WebScriptEnablingBehavior 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| AutomaticFormatSelectionEnabled |
获取或设置一个值,该值确定是否启用自动格式选择。 |
| DefaultBodyStyle |
获取或设置默认消息正文样式。 |
| DefaultOutgoingRequestFormat |
获取或设置默认传出请求消息格式。 |
| DefaultOutgoingResponseFormat |
获取或设置默认传出响应消息格式。 |
| FaultExceptionEnabled |
获取或设置一个标志,该标志指定在内部服务器错误(HTTP 状态代码:500)发生时是否生成 FaultException。 |
| HelpEnabled |
获取或设置一个值,该值确定是否启用了 WCF REST 帮助页。 |
| JavascriptCallbackParameterName |
获取或设置 JavaScript 回调参数名称。 (继承自 WebHttpBehavior) |