WebScriptEnablingBehavior Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel.Description

Zestaw:

System.ServiceModel.Web.dll

Zapewnia obsługę zachowania, które umożliwia punktom końcowym Windows Communication Foundation (WCF) odbieranie żądań HTTP z klienta ASP.NET AJAX opartego na przeglądarce. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

WebHttpBehavior

WebScriptEnablingBehavior

Uwagi

Po zastosowaniu do punktu końcowego zachowanie WebScriptEnablingBehavior umożliwia integrację WCF i ASP.NET AJAX z wyjątkiem obsługi kodowania JavaScript Object Notation (JSON). Różne typy kodowania, w tym JSON, są włączane przez WebMessageEncodingElement element lub przez odpowiednio skonfigurowany WebHttpBindingelement . Zachowanie WebScriptEnablingBehavior implementuje IEndpointBehavior element i dziedziczy z WebHttpBehaviorklasy , co umożliwia bardziej ogólny model programowania sieci Web dla usług WCF uwidaczniających punkty końcowe inne niż SOAP.

W szczególności :WebScriptEnablingBehavior

• Włącza model programowania HTTP, w tym wysyłanie do operacji na podstawie sufiksu adresu URL, obsługę wyboru czasownika HTTP (POST lub GET) i kontrolki czasu trwania pamięci podręcznej HTTP. Aby uzyskać więcej informacji na temat modelu programowania HTTP, zobacz WCF Web HTTP Programming Model Overview (Omówienie internetowego modelu programowania HTTP w programie WCF). Należy pamiętać, że domyślny czasownik HTTP to POST podczas korzystania z tego zachowania.

• Włącza prawidłowy formater dla komunikatów żądania i odpowiedzi każdej operacji — na przykład obsługę parametrów adresu URL.

• Włącza punkt końcowy serwera proxy języka JavaScript.

Aby wywołać usługę WCF z klienta AJAX ASP.NET, należy skonfigurować usługę przy użyciu powiązania WebHttpBinding, a WebScriptEnablingBehavior należy dodać do kolekcji zachowania punktu końcowego. Można to zrobić w konfiguracji przez dodanie WebScriptEnablingElement konfiguracji lub bez użycia przez aktywowanie punktu końcowego AJAX z WebScriptServiceHostFactory zamiast domyślnej fabryki w dyrektywie @ServiceHost w pliku svc.

Aby uzyskać więcej informacji na temat różnych sposobów zezwalania usłudze WCF na reagowanie na klientów AJAX ASP.NET, zobacz Tworzenie usług WCF dla ASP.NET AJAX.

Konstruktory

Nazwa	Opis
WebScriptEnablingBehavior()	Inicjuje nowe wystąpienie klasy WebScriptEnablingBehavior.

Właściwości

Nazwa	Opis
AutomaticFormatSelectionEnabled	Pobiera lub ustawia wartość, która określa, czy jest włączony wybór automatycznego formatu.
DefaultBodyStyle	Pobiera lub ustawia domyślny styl treści wiadomości.
DefaultOutgoingRequestFormat	Pobiera lub ustawia domyślny format komunikatu żądania wychodzącego.
DefaultOutgoingResponseFormat	Pobiera lub ustawia domyślny format komunikatu odpowiedzi wychodzącej.
FaultExceptionEnabled	Pobiera lub ustawia flagę określającą, czy występuje błąd FaultException w przypadku wystąpienia wewnętrznego błędu serwera (kod stanu HTTP: 500).
HelpEnabled	Pobiera lub ustawia wartość, która określa, czy strona pomocy REST programu WCF jest włączona.
JavascriptCallbackParameterName	Pobiera lub ustawia nazwę parametru wywołania zwrotnego języka JavaScript. (Odziedziczone po WebHttpBehavior)

Metody

Nazwa	Opis
AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Implementuje metodę AddBindingParameters(ServiceEndpoint, BindingParameterCollection) przekazywania danych w czasie wykonywania do powiązań w celu obsługi zachowania niestandardowego. (Odziedziczone po WebHttpBehavior)
AddClientErrorInspector(ServiceEndpoint, ClientRuntime)	Dodaje inspektora błędów klienta do określonego punktu końcowego usługi. (Odziedziczone po WebHttpBehavior)
AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher)	Zastąpij tę metodę, aby zmienić sposób obsługi błędów występujących w usłudze. (Odziedziczone po WebHttpBehavior)
ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Stosuje zachowanie klienta w punkcie końcowym.
ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Stosuje zachowanie do punktu końcowego usługi.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetOperationSelector(ServiceEndpoint)	Tworzy nowy WebHttpDispatchOperationSelector obiekt. (Odziedziczone po WebHttpBehavior)
GetQueryStringConverter(OperationDescription)	Pobiera konwerter ciągów zapytania. (Odziedziczone po WebHttpBehavior)
GetReplyClientFormatter(OperationDescription, ServiceEndpoint)	Pobiera formater odpowiedzi na kliencie dla określonego punktu końcowego i operacji usługi. (Odziedziczone po WebHttpBehavior)
GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint)	Pobiera formater odpowiedzi w usłudze dla określonego punktu końcowego i operacji usługi. (Odziedziczone po WebHttpBehavior)
GetRequestClientFormatter(OperationDescription, ServiceEndpoint)	Pobiera program formatujący żądanie na kliencie dla określonej operacji usługi i punktu końcowego. (Odziedziczone po WebHttpBehavior)
GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint)	Pobiera formater żądań w usłudze dla danej operacji usługi i punktu końcowego usługi. (Odziedziczone po WebHttpBehavior)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Validate(ServiceEndpoint)	Potwierdza, że punkt końcowy spełnia wymagania, które umożliwiają mu działanie jako punkt końcowy AJAX ASP.NET.
ValidateBinding(ServiceEndpoint)	Gwarantuje, że powiązanie jest prawidłowe do użycia z modelem programowania sieci Web WCF. (Odziedziczone po WebHttpBehavior)