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 ，以針對公開非 SOAP 端點的 WCF 服務，啟用更一般的 Web 程式設計模型。

具體地說，就是 WebScriptEnablingBehavior：

• 啟用 HTTP 程式設計模型，包括根據 URL 後置字元發送至作業、HTTP 動詞命令選擇 (POST 或 GET) 支援和 HTTP 快取期間控制。 如需 HTTP 程式設計模型的詳細資訊，請參閱 WCF WEB HTTP 程式設計模型總覽。 請注意，當使用這個行為時的預設 HTTP 動詞命令為 POST。

• 啟用各個作業之要求和回應訊息的正確格式器，例如，URL 參數的支援。

• 啟用 JavaScript Proxy 端點。

若要從 ASP.NET AJAX 用戶端呼叫 WCF 服務，服務必須使用系結來設定， WebHttpBinding 而且 WebScriptEnablingBehavior 必須加入至端點行為集合。 這可以在設定中完成，方法是在 .svc 檔案的指示詞中 WebScriptEnablingElement 使用 WebScriptServiceHostFactory 取代預設 factory，藉以新增或不使用設定 @ServiceHost 。

如需讓 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)