WebScriptEnablingBehavior Classe

Définition

Fournit la prise en charge du comportement qui permet aux points de terminaison Windows Communication Foundation (WCF) de recevoir des requêtes HTTP à partir d’un client AJAX ASP.NET basé sur un navigateur. Cette classe ne peut pas être héritée.

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
Héritage
WebScriptEnablingBehavior

Remarques

Lorsqu’il est appliqué à un point de terminaison, le comportement WebScriptEnablingBehavior active WCF et ASP.NET l’intégration AJAX, à l’exception de la prise en charge requise pour l’encodage JSON (JavaScript Object Notation). Différents types d’encodage, y compris JSON, sont activés par le WebMessageEncodingElement ou par une configuration WebHttpBindingappropriée. Le WebScriptEnablingBehavior comportement implémente et IEndpointBehavior hérite du WebHttpBehaviormodèle de programmation Web plus général pour les services WCF qui exposent des points de terminaison non SOAP.

Plus précisément, les WebScriptEnablingBehavior:

  • Active le modèle de programmation HTTP, y compris la distribution aux opérations basées sur un suffixe d’URL, la prise en charge de la sélection de verbes HTTP (POST ou GET) et le contrôle de durée du cache HTTP. Pour plus d’informations sur le modèle de programmation HTTP, consultez la vue d’ensemble du modèle de programmation HTTP web WCF. Notez que le verbe HTTP par défaut est POST lors de l’utilisation de ce comportement.

  • Active le formateur correct pour les messages de demande et de réponse de chaque opération, par exemple la prise en charge des paramètres d’URL.

  • Active le point de terminaison du proxy JavaScript.

Pour appeler un service WCF à partir d’un client AJAX ASP.NET, le service doit être configuré avec la liaison WebHttpBinding et la liaison WebScriptEnablingBehavior doit être ajoutée à la collection de comportements de point de terminaison. Cela peut être effectué dans la configuration en ajoutant ou sans utiliser la WebScriptEnablingElement configuration en activant le point de terminaison AJAX avec la WebScriptServiceHostFactory fabrique par défaut dans la directive @ServiceHost dans le fichier .svc.

Pour plus d’informations sur les différentes façons d’activer un service WCF pour répondre à ASP.NET clients AJAX, consultez Creating WCF Services for ASP.NET AJAX.

Constructeurs

Nom Description
WebScriptEnablingBehavior()

Initialise une nouvelle instance de la classe WebScriptEnablingBehavior.

Propriétés

Nom Description
AutomaticFormatSelectionEnabled

Obtient ou définit une valeur qui détermine si la sélection de format automatique est activée.

DefaultBodyStyle

Obtient ou définit le style de corps de message par défaut.

DefaultOutgoingRequestFormat

Obtient ou définit le format de message de requête sortant par défaut.

DefaultOutgoingResponseFormat

Obtient ou définit le format de message de réponse sortant par défaut.

FaultExceptionEnabled

Obtient ou définit l’indicateur qui spécifie si une exception FaultException est générée lorsqu’une erreur de serveur interne (code d’état HTTP : 500) se produit.

HelpEnabled

Obtient ou définit une valeur qui détermine si la page d’aide REST WCF est activée.

JavascriptCallbackParameterName

Obtient ou définit le nom du paramètre de rappel JavaScript.

(Hérité de WebHttpBehavior)

Méthodes

Nom Description
AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

Implémente la AddBindingParameters(ServiceEndpoint, BindingParameterCollection) méthode pour passer des données au moment de l’exécution aux liaisons pour prendre en charge le comportement personnalisé.

(Hérité de WebHttpBehavior)
AddClientErrorInspector(ServiceEndpoint, ClientRuntime)

Ajoute un inspecteur d’erreur client au point de terminaison de service spécifié.

(Hérité de WebHttpBehavior)
AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher)

Remplacez cette méthode pour modifier la façon dont les erreurs qui se produisent sur le service sont gérées.

(Hérité de WebHttpBehavior)
ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

Applique le comportement au client sur un point de terminaison.

ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

Applique le comportement au point de terminaison de service.

Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetOperationSelector(ServiceEndpoint)

Crée un objet WebHttpDispatchOperationSelector.

(Hérité de WebHttpBehavior)
GetQueryStringConverter(OperationDescription)

Obtient le convertisseur de chaîne de requête.

(Hérité de WebHttpBehavior)
GetReplyClientFormatter(OperationDescription, ServiceEndpoint)

Obtient le formateur de réponse sur le client pour le point de terminaison et l’opération de service spécifiés.

(Hérité de WebHttpBehavior)
GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint)

Obtient le formateur de réponse sur le service pour le point de terminaison et l’opération de service spécifiés.

(Hérité de WebHttpBehavior)
GetRequestClientFormatter(OperationDescription, ServiceEndpoint)

Obtient le formateur de requête sur le client pour l’opération de service et le point de terminaison spécifiés.

(Hérité de WebHttpBehavior)
GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint)

Obtient le formateur de requête sur le service pour l’opération de service et le point de terminaison de service donnés.

(Hérité de WebHttpBehavior)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
Validate(ServiceEndpoint)

Confirme que le point de terminaison répond aux exigences qui lui permettent de fonctionner en tant que point de terminaison AJAX ASP.NET.

ValidateBinding(ServiceEndpoint)

Vérifie que la liaison est valide pour une utilisation avec le modèle de programmation web WCF.

(Hérité de WebHttpBehavior)

S’applique à