WebScriptEnablingBehavior 类

定义

提供对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

注解

应用于终结点时,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)

方法

名称 说明
AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

AddBindingParameters(ServiceEndpoint, BindingParameterCollection)实现在运行时将数据传递到绑定以支持自定义行为的方法。

(继承自 WebHttpBehavior)
AddClientErrorInspector(ServiceEndpoint, ClientRuntime)

将客户端错误检查器添加到指定的服务终结点。

(继承自 WebHttpBehavior)
AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher)

重写此方法以更改服务上发生的错误处理方式。

(继承自 WebHttpBehavior)
ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

将行为应用于跨终结点的客户端。

ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

将行为应用于服务终结点。

Equals(Object)

确定指定的对象是否等于当前对象。

(继承自 Object)
GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetOperationSelector(ServiceEndpoint)

创建新的 WebHttpDispatchOperationSelector 对象。

(继承自 WebHttpBehavior)
GetQueryStringConverter(OperationDescription)

获取查询字符串转换器。

(继承自 WebHttpBehavior)
GetReplyClientFormatter(OperationDescription, ServiceEndpoint)

获取客户端上指定终结点和服务操作的回复格式化程序。

(继承自 WebHttpBehavior)
GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint)

获取指定终结点和服务操作的服务上的回复格式化程序。

(继承自 WebHttpBehavior)
GetRequestClientFormatter(OperationDescription, ServiceEndpoint)

获取客户端上指定服务操作和终结点的请求格式化程序。

(继承自 WebHttpBehavior)
GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint)

获取给定服务操作和服务终结点的服务上的请求格式化程序。

(继承自 WebHttpBehavior)
GetType()

获取当前实例的 Type

(继承自 Object)
MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
ToString()

返回一个表示当前对象的字符串。

(继承自 Object)
Validate(ServiceEndpoint)

确认终结点满足允许其充当 AJAX 终结点 ASP.NET 的要求。

ValidateBinding(ServiceEndpoint)

确保绑定与 WCF Web 编程模型一起使用有效。

(继承自 WebHttpBehavior)

适用于