WebScriptEnablingBehavior WebScriptEnablingBehavior WebScriptEnablingBehavior WebScriptEnablingBehavior Class

Definizione

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.Provides support for the behavior that enables Windows Communication Foundation (WCF) endpoints to receive HTTP requests from a browser-based ASP.NET AJAX client. Questa classe non può essere ereditata.This class cannot be inherited.

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
Ereditarietà
WebScriptEnablingBehaviorWebScriptEnablingBehaviorWebScriptEnablingBehaviorWebScriptEnablingBehavior

Commenti

Quando viene applicato a un endpoint, WebScriptEnablingBehavior il comportamento consente l'integrazione con WCF e ASP.NET AJAX, ad eccezione del supporto necessario per la codifica JavaScript Object Notation (JSON).When applied to an endpoint, the WebScriptEnablingBehavior behavior enables WCF and ASP.NET AJAX integration, except for the support required for JavaScript Object Notation (JSON) encoding. Vari tipi di codifica, inclusa la codifica JSON, sono attivati da WebMessageEncodingElement o da un oggetto WebHttpBinding opportunamente configurato.Various types of encoding, including JSON, are enabled by the WebMessageEncodingElement or by an appropriately configured WebHttpBinding. Il WebScriptEnablingBehavior comportamento WebHttpBehaviorimplementa ed eredita da, che Abilita il modello di programmazione Web più generale per i servizi WCF che espongono endpoint non SOAP. IEndpointBehaviorThe WebScriptEnablingBehavior behavior implements the IEndpointBehavior and inherits from WebHttpBehavior, which enables the more general Web programming model for WCF services exposing non-SOAP endpoints.

In particolare, l'elemento WebScriptEnablingBehavior consente di:Specifically, the WebScriptEnablingBehavior:

  • 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.Enables the HTTP programming model, including dispatch to operations based on a URL suffix, support for HTTP verb selection (POST or GET) and HTTP cache duration control. Per ulteriori informazioni sul modello di programmazione HTTP, vedere Cenni preliminari sul modello di programmazione HTTP Web WCF.For more information about the HTTP programming model, see WCF Web HTTP Programming Model Overview. Si noti che il verbo HTTP predefinito è POST quando si utilizza questo comportamento.Note that the default HTTP verb is POST when using this behavior.

  • Abilita il formattatore corretto per ogni messaggio di richiesta e risposta di ogni operazione, ad esempio, il supporto di parametri URL.Enables the correct formatter for each operation's request and response messages - for example, support for URL parameters.

  • Abilita l'endpoint proxy JavaScript.Enables the JavaScript Proxy endpoint.

Per chiamare un servizio WCF da un client ASP.NET AJAX, il servizio deve essere configurato con l' WebHttpBinding associazione WebScriptEnablingBehavior e deve essere aggiunto alla raccolta di comportamenti dell'endpoint.To call a WCF service from an ASP.NET AJAX client, the service must be configured with the WebHttpBinding binding and the WebScriptEnablingBehavior must be added to the endpoint behavior collection. Questa operazione può essere eseguita nella configurazione WebScriptEnablingElement aggiungendo o senza usare la configurazione attivando l'endpoint AJAX con il WebScriptServiceHostFactory anziché @ServiceHost la factory predefinita nella direttiva nel file con estensione svc.This can be done either in configuration by adding the WebScriptEnablingElement or without using configuration by activating the AJAX endpoint with the WebScriptServiceHostFactory instead of the default factory in the @ServiceHost directive in the .svc file.

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.For more information about different ways to enable a WCF service to respond to ASP.NET AJAX clients, see Creating WCF Services for ASP.NET AJAX.

Costruttori

WebScriptEnablingBehavior() WebScriptEnablingBehavior() WebScriptEnablingBehavior() WebScriptEnablingBehavior()

Inizializza una nuova istanza della classe WebScriptEnablingBehavior.Initializes a new instance of the WebScriptEnablingBehavior class.

Proprietà

AutomaticFormatSelectionEnabled AutomaticFormatSelectionEnabled AutomaticFormatSelectionEnabled AutomaticFormatSelectionEnabled

Ottiene o imposta un valore che determina se la selezione del formato automatica è abilitata.Gets or sets a value that determines if automatic format selection is enabled.

DefaultBodyStyle DefaultBodyStyle DefaultBodyStyle DefaultBodyStyle

Ottiene o imposta il lo stile predefinito per il corpo del messaggio.Gets or sets the default message body style.

DefaultOutgoingRequestFormat DefaultOutgoingRequestFormat DefaultOutgoingRequestFormat DefaultOutgoingRequestFormat

Ottiene o imposta il formato del messaggio di richiesta in uscita predefinito.Gets or sets the default outgoing request message format.

DefaultOutgoingResponseFormat DefaultOutgoingResponseFormat DefaultOutgoingResponseFormat DefaultOutgoingResponseFormat

Ottiene o imposta il formato del messaggio di risposta in uscita predefinito.Gets or sets the default outgoing response message format.

FaultExceptionEnabled FaultExceptionEnabled FaultExceptionEnabled 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).Gets or sets the flag that specifies whether a FaultException is generated when an internal server error (HTTP status code: 500) occurs.

HelpEnabled HelpEnabled HelpEnabled HelpEnabled

Ottiene o imposta un valore che determina se la Guida REST WCF è abilitata.Gets or sets a value that determines if the WCF REST Help page is enabled.

JavascriptCallbackParameterName JavascriptCallbackParameterName JavascriptCallbackParameterName JavascriptCallbackParameterName

Ottiene o imposta il nome del parametro di callback JavaScript.Gets or sets the JavaScript callback parameter name.

(Inherited from WebHttpBehavior)

Metodi

AddBindingParameters(ServiceEndpoint, BindingParameterCollection) AddBindingParameters(ServiceEndpoint, BindingParameterCollection) AddBindingParameters(ServiceEndpoint, BindingParameterCollection) 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.Implements the AddBindingParameters(ServiceEndpoint, BindingParameterCollection) method to pass data at runtime to bindings to support custom behavior.

(Inherited from WebHttpBehavior)
AddClientErrorInspector(ServiceEndpoint, ClientRuntime) AddClientErrorInspector(ServiceEndpoint, ClientRuntime) AddClientErrorInspector(ServiceEndpoint, ClientRuntime) AddClientErrorInspector(ServiceEndpoint, ClientRuntime)

Aggiunge un controllo dell'errore client all'endpoint del servizio specificato.Adds a client error inspector to the specified service endpoint.

(Inherited from WebHttpBehavior)
AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher) AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher) AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher) AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher)

Eseguire l'override di questo metodo per modificare la gestione degli errori che si verificano nel servizio.Override this method to change the way errors that occur on the service are handled.

(Inherited from WebHttpBehavior)
ApplyClientBehavior(ServiceEndpoint, ClientRuntime) ApplyClientBehavior(ServiceEndpoint, ClientRuntime) ApplyClientBehavior(ServiceEndpoint, ClientRuntime) ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

Applica il comportamento al client attraverso un endpoint.Applies the behavior to the client across an endpoint.

ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

Applica il comportamento all'endpoint del servizio.Applies the behavior to the service endpoint.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetOperationSelector(ServiceEndpoint) GetOperationSelector(ServiceEndpoint) GetOperationSelector(ServiceEndpoint) GetOperationSelector(ServiceEndpoint)

Crea un nuovo oggetto WebHttpDispatchOperationSelector.Creates a new WebHttpDispatchOperationSelector object.

(Inherited from WebHttpBehavior)
GetQueryStringConverter(OperationDescription) GetQueryStringConverter(OperationDescription) GetQueryStringConverter(OperationDescription) GetQueryStringConverter(OperationDescription)

Ottiene il convertitore della stringa di query.Gets the query string converter.

(Inherited from WebHttpBehavior)
GetReplyClientFormatter(OperationDescription, ServiceEndpoint) GetReplyClientFormatter(OperationDescription, ServiceEndpoint) GetReplyClientFormatter(OperationDescription, ServiceEndpoint) GetReplyClientFormatter(OperationDescription, ServiceEndpoint)

Ottiene il formattatore della risposta sul client per l'endpoint e l'operazione del servizio specificati.Gets the reply formatter on the client for the specified endpoint and service operation.

(Inherited from WebHttpBehavior)
GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint) GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint) GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint) GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint)

Ottiene il formattatore della risposta sul servizio per l'endpoint e l'operazione del servizio specificati.Gets the reply formatter on the service for the specified endpoint and service operation.

(Inherited from WebHttpBehavior)
GetRequestClientFormatter(OperationDescription, ServiceEndpoint) GetRequestClientFormatter(OperationDescription, ServiceEndpoint) GetRequestClientFormatter(OperationDescription, ServiceEndpoint) GetRequestClientFormatter(OperationDescription, ServiceEndpoint)

Ottiene il formattatore della richiesta sul client per l'operazione del servizio e l'endpoint specificati.Gets the request formatter on the client for the specified service operation and endpoint.

(Inherited from WebHttpBehavior)
GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint) GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint) GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint) GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint)

Ottiene il formattatore della richiesta sul servizio per un'operazione e un endpoint del servizio specificati.Gets the request formatter on the service for the given service operation and service endpoint.

(Inherited from WebHttpBehavior)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
Validate(ServiceEndpoint) Validate(ServiceEndpoint) Validate(ServiceEndpoint) Validate(ServiceEndpoint)

Conferma che l'endpoint soddisfa i requisiti che gli consentono di funzionare come endpoint AJAX ASP.NET.Confirms that the endpoint meets the requirements that allow it to function as an ASP.NET AJAX endpoint.

ValidateBinding(ServiceEndpoint) ValidateBinding(ServiceEndpoint) ValidateBinding(ServiceEndpoint) ValidateBinding(ServiceEndpoint)

Assicura che l'associazione sia valida per l'utilizzo con il modello di programmazione Web WCF.Ensures the binding is valid for use with the WCF Web Programming Model.

(Inherited from WebHttpBehavior)
ValidateOperation(OperationDescription) ValidateOperation(OperationDescription) ValidateOperation(OperationDescription) ValidateOperation(OperationDescription) Inherited from WebHttpBehavior

Implementazioni dell'interfaccia esplicita

IWmiInstanceProvider.FillInstance(IWmiInstance) IWmiInstanceProvider.FillInstance(IWmiInstance) IWmiInstanceProvider.FillInstance(IWmiInstance) IWmiInstanceProvider.FillInstance(IWmiInstance) Inherited from WebHttpBehavior
IWmiInstanceProvider.GetInstanceType() IWmiInstanceProvider.GetInstanceType() IWmiInstanceProvider.GetInstanceType() IWmiInstanceProvider.GetInstanceType() Inherited from WebHttpBehavior

Si applica a