WebScriptEnablingBehavior Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce il supporto per il comportamento che consente agli endpoint Windows Communication Foundation (WCF) di ricevere richieste HTTP da un client AJAX basato su browser ASP.NET. La classe non può essere ereditata.
public ref class WebScriptEnablingBehavior sealed : System::ServiceModel::Description::WebHttpBehaviorpublic sealed class WebScriptEnablingBehavior : System.ServiceModel.Description.WebHttpBehaviortype WebScriptEnablingBehavior = class
inherit WebHttpBehaviorPublic NotInheritable Class WebScriptEnablingBehavior
Inherits WebHttpBehavior- Ereditarietà
Commenti
Se applicato a un endpoint, il comportamento WebScriptEnablingBehavior abilita l'integrazione WCF e ASP.NET AJAX, ad eccezione del supporto necessario per la codifica JSON (JavaScript Object Notation). Vari tipi di codifica, tra cui JSON, sono abilitati da WebMessageEncodingElement o da un oggetto configurato WebHttpBindingin modo appropriato. Il WebScriptEnablingBehavior comportamento implementa IEndpointBehavior e eredita da WebHttpBehavior, che consente il modello di programmazione Web più generale per i servizi WCF che espongono endpoint non SOAP.
In particolare, :WebScriptEnablingBehavior
Abilita il modello di programmazione HTTP, incluso l'invio alle operazioni in base a un suffisso URL, il supporto per la selezione dei verbi HTTP (POST o GET) e il controllo della durata della cache HTTP. Per altre informazioni sul modello di programmazione HTTP, vedere Cenni preliminari sul modello di programmazione HTTP Web WCF. Si noti che il verbo HTTP predefinito è POST quando si usa questo comportamento.
Abilita il formattatore corretto per i messaggi di richiesta e risposta di ogni operazione, ad esempio il supporto per i parametri URL.
Abilita l'endpoint proxy JavaScript.
Per chiamare un servizio WCF da un client AJAX ASP.NET, è necessario configurare il servizio con l'associazione WebHttpBinding e l'WebScriptEnablingBehavior deve essere aggiunto alla raccolta di comportamenti dell'endpoint. Questa operazione può essere eseguita nella configurazione aggiungendo o senza usare la WebScriptEnablingElement configurazione attivando l'endpoint AJAX con anziché WebScriptServiceHostFactory la factory predefinita nella direttiva @ServiceHost nel file con estensione svc.
Per altre informazioni sui diversi modi per consentire a un servizio WCF di rispondere ai client AJAX ASP.NET, vedere Creating WCF Services for ASP.NET AJAX.
Costruttori
| Nome | Descrizione |
|---|---|
| WebScriptEnablingBehavior() |
Inizializza una nuova istanza della classe WebScriptEnablingBehavior. |
Proprietà
| Nome | Descrizione |
|---|---|
| AutomaticFormatSelectionEnabled |
Ottiene o imposta un valore che determina se la selezione automatica del formato è abilitata. |
| DefaultBodyStyle |
Ottiene o imposta lo stile predefinito del corpo del messaggio. |
| DefaultOutgoingRequestFormat |
Ottiene o imposta il formato del messaggio di richiesta in uscita predefinito. |
| DefaultOutgoingResponseFormat |
Ottiene o imposta il formato del messaggio di risposta in uscita predefinito. |
| FaultExceptionEnabled |
Ottiene o imposta il flag che specifica se viene generata un'eccezione FaultException quando si verifica un errore interno del server (codice di stato HTTP: 500). |
| HelpEnabled |
Ottiene o imposta un valore che determina se la pagina della Guida REST WCF è abilitata. |
| JavascriptCallbackParameterName |
Ottiene o imposta il nome del parametro di callback JavaScript. (Ereditato da WebHttpBehavior) |
Metodi
| Nome | Descrizione |
|---|---|
| AddBindingParameters(ServiceEndpoint, BindingParameterCollection) |
Implementa il AddBindingParameters(ServiceEndpoint, BindingParameterCollection) metodo per passare i dati in fase di esecuzione alle associazioni per supportare il comportamento personalizzato. (Ereditato da WebHttpBehavior) |
| AddClientErrorInspector(ServiceEndpoint, ClientRuntime) |
Aggiunge un controllo errori client all'endpoint di servizio specificato. (Ereditato da WebHttpBehavior) |
| AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher) |
Eseguire l'override di questo metodo per modificare il modo in cui vengono gestiti gli errori che si verificano nel servizio. (Ereditato da WebHttpBehavior) |
| ApplyClientBehavior(ServiceEndpoint, ClientRuntime) |
Applica il comportamento al client in un endpoint. |
| ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) |
Applica il comportamento all'endpoint del servizio. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetOperationSelector(ServiceEndpoint) |
Crea un nuovo oggetto WebHttpDispatchOperationSelector. (Ereditato da WebHttpBehavior) |
| GetQueryStringConverter(OperationDescription) |
Ottiene il convertitore di stringhe di query. (Ereditato da WebHttpBehavior) |
| GetReplyClientFormatter(OperationDescription, ServiceEndpoint) |
Ottiene il formattatore di risposta nel client per l'endpoint e l'operazione del servizio specificati. (Ereditato da WebHttpBehavior) |
| GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint) |
Ottiene il formattatore di risposta nel servizio per l'endpoint e l'operazione del servizio specificati. (Ereditato da WebHttpBehavior) |
| GetRequestClientFormatter(OperationDescription, ServiceEndpoint) |
Ottiene il formattatore della richiesta nel client per l'operazione e l'endpoint del servizio specificati. (Ereditato da WebHttpBehavior) |
| GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint) |
Ottiene il formattatore di richiesta nel servizio per l'operazione del servizio e l'endpoint di servizio specificati. (Ereditato da WebHttpBehavior) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| Validate(ServiceEndpoint) |
Conferma che l'endpoint soddisfa i requisiti che lo consentono di funzionare come endpoint AJAX ASP.NET. |
| ValidateBinding(ServiceEndpoint) |
Assicura che l'associazione sia valida per l'uso con il modello di programmazione Web WCF. (Ereditato da WebHttpBehavior) |
