WebScriptEnablingBehavior Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bietet Unterstützung für das Verhalten, das WCF-Endpunkten ermöglicht, HTTP-Anforderungen von einem browserbasierten ASP.NET AJAX-Client zu empfangen. Diese Klasse kann nicht vererbt werden.
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- Vererbung
Hinweise
Wenn das Verhalten auf einen Endpunkt angewendet wird, WebScriptEnablingBehavior aktiviert es die WCF-und ASP.NET-AJAX-Integration, mit Ausnahme der Unterstützung für die JavaScript Object Notation-Codierung (JSON). Verschiedene Typen der Codierung, einschließlich JSON, werden vom WebMessageEncodingElement oder einer entsprechend konfigurierten WebHttpBinding aktiviert. Das WebScriptEnablingBehavior -Verhalten implementiert die IEndpointBehavior und erbt von WebHttpBehavior , wodurch das allgemeinere webprogrammier Modell für WCF-Dienste aktiviert wird, die nicht-SOAP-Endpunkte verfügbar machen.
Insbesondere WebScriptEnablingBehavior:
Aktiviert das HTTP-Programmiermodell, einschließlich der Verteilung auf Vorgänge, die auf einem URL-Suffix basieren, Unterstützung der HTTP-Verbauswahl (POST oder GET) und Steuerung der HTTP-Cachedauer. Weitere Informationen zum HTTP-Programmiermodell finden Sie unter Übersicht über das WCF-Web-HTTP-Programmiermodell. Beachten Sie, dass das Standard-HTTP-Verb POST ist, wenn dieses Verhalten verwendet wird.
Aktiviert das richtige Formatierungsprogramm für die Anforderungs- und Antwortnachrichten der einzelnen Vorgänge, zum Beispiel Unterstützung für URL-Parameter.
Aktiviert den JavaScript-Proxyendpunkt.
Um einen WCF-Dienst von einem ASP.NET-AJAX-Client aus aufzurufen, muss der Dienst mit der-Bindung konfiguriert werden, WebHttpBinding und der WebScriptEnablingBehavior muss der Endpunkt Verhaltens Auflistung hinzugefügt werden. Dies kann entweder in der Konfiguration durch Hinzufügen von WebScriptEnablingElement oder ohne Konfiguration erfolgen, indem der AJAX-Endpunkt mit WebScriptServiceHostFactory anstelle der Standardfactory in der- @ServiceHost Direktive in der SVC-Datei aktiviert wird.
Weitere Informationen zu den verschiedenen Möglichkeiten, einen WCF-Dienst für die Reaktion auf ASP.NET AJAX-Clients zu aktivieren, finden Sie unter Erstellen von WCF-Diensten für ASP.NET AJAX.
Konstruktoren
| WebScriptEnablingBehavior() |
Initialisiert eine neue Instanz der WebScriptEnablingBehavior-Klasse. |
Eigenschaften
| AutomaticFormatSelectionEnabled |
Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die automatische Formatauswahl aktiviert ist. |
| AutomaticFormatSelectionEnabled |
Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die automatische Formatauswahl aktiviert ist. (Geerbt von WebHttpBehavior) |
| DefaultBodyStyle |
Ruft den Standardnachrichtentext ab oder legt diesen fest. |
| DefaultOutgoingRequestFormat |
Ruft das Standardnachrichtenformat für ausgehende Anforderungen ab oder legt es fest. |
| DefaultOutgoingResponseFormat |
Ruft das Standardformat für ausgehende Antwortnachrichten ab oder legt es fest. |
| FaultExceptionEnabled |
Ruft das Flag ab bzw. legt das Flag fest, das angibt, ob ein FaultException-Element generiert wird, wenn ein interner Serverfehler (HTTP-Statuscode: 500) auftritt. |
| FaultExceptionEnabled |
Ruft das Flag ab bzw. legt das Flag fest, das angibt, ob ein FaultException-Element generiert wird, wenn ein interner Serverfehler (HTTP-Statuscode: 500) auftritt. (Geerbt von WebHttpBehavior) |
| HelpEnabled |
Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die WCF-REST-Hilfeseite aktiviert ist. |
| HelpEnabled |
Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die WCF-Hilfeseite aktiviert ist. (Geerbt von WebHttpBehavior) |
| JavascriptCallbackParameterName |
Ruft den Namen des JavaScript-Rückrufparameters ab bzw. legt ihn fest. (Geerbt von WebHttpBehavior) |
Methoden
| AddBindingParameters(ServiceEndpoint, BindingParameterCollection) |
Implementiert die AddBindingParameters(ServiceEndpoint, BindingParameterCollection)-Methode, um zur Laufzeit Daten an Bindungen zu übergeben und benutzerdefiniertes Verhalten zu unterstützen. (Geerbt von WebHttpBehavior) |
| AddClientErrorInspector(ServiceEndpoint, ClientRuntime) |
Fügt dem angegebenen Dienstendpunkt einen Clientfehlerinspektor hinzu. (Geerbt von WebHttpBehavior) |
| AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher) |
Überschreiben Sie diese Methode, um die Handhabung von Fehlern zu ändern, die in diesem Dienst auftreten. (Geerbt von WebHttpBehavior) |
| ApplyClientBehavior(ServiceEndpoint, ClientRuntime) |
Wendet das Verhalten über einen Endpunkt auf den Client an. |
| ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) |
Wendet das Verhalten auf den Dienstendpunkt an. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetOperationSelector(ServiceEndpoint) |
Erstellt ein neues WebHttpDispatchOperationSelector-Objekt. (Geerbt von WebHttpBehavior) |
| GetQueryStringConverter(OperationDescription) |
Ruft den Abfragezeichenfolgenkonverter ab. (Geerbt von WebHttpBehavior) |
| GetReplyClientFormatter(OperationDescription, ServiceEndpoint) |
Ruft das Antwortformatierungsprogramm auf dem Client für den angegebenen Endpunkt und den Dienstvorgang ab. (Geerbt von WebHttpBehavior) |
| GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint) |
Ruft das Antwortformatierungsprogramm in dem Dienst für den angegebenen Endpunkt und den Dienstvorgang ab. (Geerbt von WebHttpBehavior) |
| GetRequestClientFormatter(OperationDescription, ServiceEndpoint) |
Ruft das Anforderungsformatierungsprogramm auf dem Client für den angegebenen Dienstvorgang und Endpunkt ab. (Geerbt von WebHttpBehavior) |
| GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint) |
Ruft das Anforderungsformatierungsprogramm in dem Dienst für den angegebenen Dienstvorgang und Endpunkt ab. (Geerbt von WebHttpBehavior) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| Validate(ServiceEndpoint) |
Bestätigt, dass der Endpunkt die Anforderungen erfüllt, die ihm ermöglichen, als ASP.NET AJAX-Endpunkt zu funktionieren. |
| ValidateBinding(ServiceEndpoint) |
Stellt sicher, dass die Bindung für die Verwendung mit dem WCF-Webprogrammiermodell gültig ist. (Geerbt von WebHttpBehavior) |
| ValidateOperation(OperationDescription) | (Geerbt von WebHttpBehavior) |