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 supporto per il comportamento che consente agli endpoint WCF (Windows Communication Foundation) di ricevere richieste HTTP da un client AJAX ASP.NET basato su browser. 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
Quando viene applicato a un endpoint, il WebScriptEnablingBehavior comportamento consente l'integrazione con WCF e ASP.NET AJAX, ad eccezione del supporto necessario per la codifica JavaScript Object Notation (JSON). Vari tipi di codifica, inclusa la codifica JSON, sono attivati da WebMessageEncodingElement o da un oggetto WebHttpBinding opportunamente configurato. Il WebScriptEnablingBehavior comportamento implementa IEndpointBehavior ed eredita da WebHttpBehavior , che Abilita il modello di programmazione Web più generale per i servizi WCF che espongono endpoint non SOAP.
In particolare, l'elemento WebScriptEnablingBehavior consente di:
Attiva il modello di programmazione HTTP, inclusa la distribuzione a operazioni basate su un suffisso URL, il supporto per la selezione del verbo HTTP (POST o GET) e il controllo della durata della cache HTTP. Per ulteriori 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 utilizza questo comportamento.
Abilita il formattatore corretto per ogni messaggio di richiesta e risposta di ogni operazione, ad esempio, il supporto di parametri URL.
Abilita l'endpoint proxy JavaScript.
Per chiamare un servizio WCF da un client ASP.NET AJAX, il servizio deve essere configurato con l' WebHttpBinding associazione e WebScriptEnablingBehavior deve essere aggiunto alla raccolta di comportamenti dell'endpoint. Questa operazione può essere eseguita nella configurazione aggiungendo WebScriptEnablingElement o senza usare la configurazione attivando l'endpoint AJAX con il WebScriptServiceHostFactory anziché la factory predefinita nella @ServiceHost direttiva nel file con estensione svc.
Per ulteriori informazioni sui diversi modi per consentire a un servizio WCF di rispondere ai client AJAX ASP.NET, vedere creazione di servizi WCF per ASP.NET AJAX.
Costruttori
| WebScriptEnablingBehavior() |
Inizializza una nuova istanza della classe WebScriptEnablingBehavior. |
Proprietà
| AutomaticFormatSelectionEnabled |
Ottiene o imposta un valore che determina se la selezione del formato automatica è abilitata. |
| AutomaticFormatSelectionEnabled |
Ottiene o imposta un valore che determina se la selezione del formato automatica è abilitata. (Ereditato da WebHttpBehavior) |
| DefaultBodyStyle |
Ottiene o imposta il lo stile predefinito per il 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 del server interno (codice di stato HTTP: 500). |
| FaultExceptionEnabled |
Ottiene o imposta il flag che specifica se viene generata un'eccezione FaultException quando si verifica un errore del server interno (codice di stato HTTP: 500). (Ereditato da WebHttpBehavior) |
| HelpEnabled |
Ottiene o imposta un valore che determina se la Guida REST WCF è abilitata. |
| HelpEnabled |
Ottiene o imposta un valore che determina se la Guida WCF è abilitata. (Ereditato da WebHttpBehavior) |
| JavascriptCallbackParameterName |
Ottiene o imposta il nome del parametro di callback JavaScript. (Ereditato da WebHttpBehavior) |
Metodi
| AddBindingParameters(ServiceEndpoint, BindingParameterCollection) |
Implementa il metodo AddBindingParameters(ServiceEndpoint, BindingParameterCollection) per passare dati alle associazioni in fase di esecuzione, al fine di supportare il comportamento personalizzato. (Ereditato da WebHttpBehavior) |
| AddClientErrorInspector(ServiceEndpoint, ClientRuntime) |
Aggiunge un controllo dell'errore client all'endpoint del servizio specificato. (Ereditato da WebHttpBehavior) |
| AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher) |
Eseguire l'override di questo metodo per modificare la gestione degli errori che si verificano nel servizio. (Ereditato da WebHttpBehavior) |
| ApplyClientBehavior(ServiceEndpoint, ClientRuntime) |
Applica il comportamento al client attraverso 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 della stringa di query. (Ereditato da WebHttpBehavior) |
| GetReplyClientFormatter(OperationDescription, ServiceEndpoint) |
Ottiene il formattatore della risposta sul client per l'endpoint e l'operazione del servizio specificati. (Ereditato da WebHttpBehavior) |
| GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint) |
Ottiene il formattatore della risposta sul servizio per l'endpoint e l'operazione del servizio specificati. (Ereditato da WebHttpBehavior) |
| GetRequestClientFormatter(OperationDescription, ServiceEndpoint) |
Ottiene il formattatore della richiesta sul client per l'operazione del servizio e l'endpoint specificati. (Ereditato da WebHttpBehavior) |
| GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint) |
Ottiene il formattatore della richiesta sul servizio per un'operazione e un endpoint del servizio specificati. (Ereditato da WebHttpBehavior) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (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 gli consentono di funzionare come endpoint AJAX ASP.NET. |
| ValidateBinding(ServiceEndpoint) |
Assicura che l'associazione sia valida per l'utilizzo con il modello di programmazione Web WCF. (Ereditato da WebHttpBehavior) |
| ValidateOperation(OperationDescription) | (Ereditato da WebHttpBehavior) |