WebScriptEnablingBehavior WebScriptEnablingBehavior WebScriptEnablingBehavior WebScriptEnablingBehavior Class

Definición

Proporciona la compatibilidad para el comportamiento que permite a los puntos de conexión Windows Communication Foundation (WCF) recibir las solicitudes HTTP de un cliente AJAX de ASP.NET basado en un explorador.Provides support for the behavior that enables Windows Communication Foundation (WCF) endpoints to receive HTTP requests from a browser-based ASP.NET AJAX client. Esta clase no puede heredarse.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
Herencia
WebScriptEnablingBehaviorWebScriptEnablingBehaviorWebScriptEnablingBehaviorWebScriptEnablingBehavior

Comentarios

Cuando se aplica a un punto de WebScriptEnablingBehavior conexión, el comportamiento habilita la integración de AJAX de WCF y ASP.net, excepto la compatibilidad necesaria con la codificación de notación de objetos JavaScript (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. Varios tipos de codificación, incluido JSON, están habilitados por WebMessageEncodingElement o por un WebHttpBindingadecuadamente configurado.Various types of encoding, including JSON, are enabled by the WebMessageEncodingElement or by an appropriately configured WebHttpBinding. El WebScriptEnablingBehavior comportamiento implementa IEndpointBehavior y hereda de WebHttpBehavior, que habilita el modelo de programación web más general para los servicios WCF que exponen extremos que no son SOAP.The WebScriptEnablingBehavior behavior implements the IEndpointBehavior and inherits from WebHttpBehavior, which enables the more general Web programming model for WCF services exposing non-SOAP endpoints.

Específicamente, WebScriptEnablingBehavior:Specifically, the WebScriptEnablingBehavior:

  • Habilita el modelo de programación HTTP, incluida la distribución a las operaciones basadas en un sufijo de la dirección URL, la compatibilidad para la selección de verbos HTTP (POST o GET) y el control de duración del almacenamiento en caché de 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. Para obtener más información sobre el modelo de programación HTTP, consulte información general sobre el modelo de programación web http de WCF.For more information about the HTTP programming model, see WCF Web HTTP Programming Model Overview. Observe que el verbo HTTP predeterminado es POST al utilizar este comportamiento.Note that the default HTTP verb is POST when using this behavior.

  • Habilita el formateador correcto para los mensajes de respuesta y solicitud de cada operación -por ejemplo, admite los parámetros URL-.Enables the correct formatter for each operation's request and response messages - for example, support for URL parameters.

  • Habilita el punto de conexión proxy de JavaScript.Enables the JavaScript Proxy endpoint.

Para llamar a un servicio WCF desde un cliente de ASP.NET AJAX, el servicio se debe configurar WebHttpBinding con el enlace WebScriptEnablingBehavior y se debe agregar a la colección de comportamientos del extremo.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. Esto se puede hacer en la configuración agregando WebScriptEnablingElement o sin utilizar la configuración activando el punto de conexión de Ajax WebScriptServiceHostFactory con en lugar del generador predeterminado en @ServiceHost la Directiva en el archivo. 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.

Para obtener más información sobre las distintas formas de permitir que un servicio WCF responda a los clientes de ASP.NET AJAX, consulte creación de servicios WCF para 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.

Constructores

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

Inicializa una nueva instancia de la clase WebScriptEnablingBehavior.Initializes a new instance of the WebScriptEnablingBehavior class.

Propiedades

AutomaticFormatSelectionEnabled AutomaticFormatSelectionEnabled AutomaticFormatSelectionEnabled AutomaticFormatSelectionEnabled

Obtiene o establece un valor que determina si la selección de formato automática está habilitada.Gets or sets a value that determines if automatic format selection is enabled.

DefaultBodyStyle DefaultBodyStyle DefaultBodyStyle DefaultBodyStyle

Obtiene o establece el estilo de cuerpo del mensaje predeterminado.Gets or sets the default message body style.

DefaultOutgoingRequestFormat DefaultOutgoingRequestFormat DefaultOutgoingRequestFormat DefaultOutgoingRequestFormat

Obtiene o establece el formato del mensaje de solicitud de salida predeterminado.Gets or sets the default outgoing request message format.

DefaultOutgoingResponseFormat DefaultOutgoingResponseFormat DefaultOutgoingResponseFormat DefaultOutgoingResponseFormat

Obtiene o establece el formato de mensaje de respuesta saliente predeterminado.Gets or sets the default outgoing response message format.

FaultExceptionEnabled FaultExceptionEnabled FaultExceptionEnabled FaultExceptionEnabled

Obtiene o establece la marca que especifica si se genera FaultException cuando se produce un error de servidor interno (código de estado 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

Obtiene o establece un valor que determina si la página de Ayuda de REST de WCF está habilitada.Gets or sets a value that determines if the WCF REST Help page is enabled.

JavascriptCallbackParameterName JavascriptCallbackParameterName JavascriptCallbackParameterName JavascriptCallbackParameterName

Obtiene o establece el nombre del parámetro de devolución de llamada de JavaScript.Gets or sets the JavaScript callback parameter name.

(Inherited from WebHttpBehavior)

Métodos

AddBindingParameters(ServiceEndpoint, BindingParameterCollection) AddBindingParameters(ServiceEndpoint, BindingParameterCollection) AddBindingParameters(ServiceEndpoint, BindingParameterCollection) AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

Implementa el método AddBindingParameters(ServiceEndpoint, BindingParameterCollection) para pasar datos en tiempo de ejecución a enlaces para admitir el comportamiento personalizado.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)

Agrega un inspector del error del cliente al punto de conexión de servicio especificado.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)

Invalide este método para cambiar la manera en que se administran los errores que se producen en el servicio.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)

Aplica el comportamiento al cliente en todo un punto de conexión.Applies the behavior to the client across an endpoint.

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

Aplica el comportamiento al punto de conexión del servicio.Applies the behavior to the service endpoint.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Crea un nuevo objeto WebHttpDispatchOperationSelector.Creates a new WebHttpDispatchOperationSelector object.

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

Obtiene el convertidor de la cadena de consulta.Gets the query string converter.

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

Obtiene el formateador de respuesta del cliente para el extremo especificado y la operación de servicio.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)

Obtiene el formateador de respuesta del servicio para el extremo especificado y la operación de servicio.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)

Obtiene el formateador de solicitud del cliente para la operación de servicio y el extremo especificados.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)

Obtiene el formateador de solicitud del servicio para la operación de servicio y el extremo de servicio dados.Gets the request formatter on the service for the given service operation and service endpoint.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

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

Confirma que el punto de conexión cumple los requisitos que le permiten funcionar como un punto de conexión de AJAX de 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)

Se asegura de que el enlace sea válido para usarse con el Modelo de programación web de 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

Implementaciones de interfaz explícitas

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

Se aplica a