WebScriptEnablingBehavior クラス

定義

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 動作により、JavaScript Object Notation (JSON) エンコードに必要なサポートを除き、WCF と ASP.NET AJAX の統合が可能になります。 JSON を含むさまざまな種類のエンコードは、 WebMessageEncodingElement または適切に構成された WebHttpBindingによって有効になります。 WebScriptEnablingBehavior動作では、IEndpointBehaviorが実装され、WebHttpBehaviorから継承されます。これにより、SOAP 以外のエンドポイントを公開する WCF サービスの一般的な Web プログラミング モデルが可能になります。

具体的には、次の WebScriptEnablingBehavior。

• URL サフィックスに基づく操作へのディスパッチ、HTTP 動詞選択 (POST または GET) のサポート、HTTP キャッシュ期間の制御など、HTTP プログラミング モデルを有効にします。 HTTP プログラミング モデルの詳細については、「 WCF Web HTTP プログラミング モデルの概要」を参照してください。 この動作を使用する場合、既定の HTTP 動詞は POST であることに注意してください。

• URL パラメーターのサポートなど、各操作の要求メッセージと応答メッセージに対して適切なフォーマッタを有効にします。

• JavaScript プロキシ エンドポイントを有効にします。

ASP.NET AJAX クライアントから WCF サービスを呼び出すには、サービスを WebHttpBinding バインディングで構成し、WebScriptEnablingBehaviorをエンドポイント動作コレクションに追加する必要があります。 これは、構成でWebScriptEnablingElementを追加するか、.svc ファイルの WebScriptServiceHostFactory既定のファクトリではなく、を使用して AJAX エンドポイントをアクティブ化して構成を使用せずに行うことができます。

WCF サービスが ASP.NET AJAX クライアントに応答できるようにするさまざまな方法の詳細については、「 WCF Services for ASP.NET AJAX の作成を参照してください。