WebScriptEnablingBehavior 类

定义

命名空间:

System.ServiceModel.Description

程序集:

System.ServiceModel.Web.dll

为启用 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

继承

Object

WebHttpBehavior

WebScriptEnablingBehavior

注解

当应用于终结点时，该 WebScriptEnablingBehavior 行为会启用 WCF 和 ASP.NET AJAX 集成，但 JavaScript 对象表示法 (JSON) 编码所需的支持。 各种类型的编码（包括 JSON）由 WebMessageEncodingElement 启用，或者由进行了适当配置的 WebHttpBinding 启用。 此 WebScriptEnablingBehavior 行为实现 IEndpointBehavior 并从继承 WebHttpBehavior ，这将为 WCF 服务公开非 SOAP 终结点的更常规的 Web 编程模型。

具体来说，WebScriptEnablingBehavior：

• 启用 HTTP 编程模型，包括调度基于 URL 后缀的操作、支持 HTTP 谓词选择（POST 或 GET）以及 HTTP 缓存持续时间控制。 有关 HTTP 编程模型的详细信息，请参阅 WCF WEB HTTP 编程模型概述。 请注意，在使用此行为时，默认的 HTTP 谓词为 POST。

• 为每个操作的请求和响应消息启用正确的格式化程序，例如，对 URL 参数的支持。

• 启用 JavaScript 代理终结点。

若要从 ASP.NET AJAX 客户端调用 WCF 服务，必须使用绑定来配置服务， WebHttpBinding 并且 WebScriptEnablingBehavior 必须将该服务添加到终结点行为集合中。 这可以在配置中完成，方法是通过在 WebScriptEnablingElement WebScriptServiceHostFactory .svc 文件中的 @ServiceHost 指令中使用而非默认工厂激活 AJAX 终结点来添加或而不使用配置。

有关使 WCF 服务能够响应 ASP.NET AJAX 客户端的不同方法的详细信息，请参阅为 ASP.NET Ajax 创建 WCF 服务。

构造函数

WebScriptEnablingBehavior()

初始化 WebScriptEnablingBehavior 类的新实例。

属性

AutomaticFormatSelectionEnabled	获取或设置一个值，该值确定是否启用自动格式选择。
AutomaticFormatSelectionEnabled	获取或设置一个值，该值确定是否启用自动格式选择。 (继承自 WebHttpBehavior)
DefaultBodyStyle	获取或设置默认消息正文样式。
DefaultOutgoingRequestFormat	获取或设置默认的传出请求消息格式。
DefaultOutgoingResponseFormat	获取或设置默认的传出响应消息格式。
FaultExceptionEnabled	获取或设置用于指定在发生内部服务器错误（HTTP 状态代码：500）时是否生成 FaultException 的标志。
FaultExceptionEnabled	获取或设置用于指定在发生内部服务器错误（HTTP 状态代码：500）时是否生成 FaultException 的标志。 (继承自 WebHttpBehavior)
HelpEnabled	获取或设置一个值，该值确定是否启用了 WCF REST 帮助页。
HelpEnabled	获取或设置一个值，该值确定是否启用了 WCF 帮助页。 (继承自 WebHttpBehavior)
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)	确认该终结点满足使它能够用作 ASP.NET AJAX 终结点的要求。
ValidateBinding(ServiceEndpoint)	确保绑定在与 WCF Web 编程模型一起使用时有效。 (继承自 WebHttpBehavior)
ValidateOperation(OperationDescription)	(继承自 WebHttpBehavior)