WebScriptEnablingBehavior Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Обеспечивает поддержку поведения, позволяющего конечным точкам Windows Communication Foundation (WCF) получать HTTP-запросы от клиента ASP.NET AJAX на основе браузера. Этот класс не наследуется.
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
- Наследование
Комментарии
При применении к конечной точке WebScriptEnablingBehavior поведение обеспечивает ИНТЕГРАЦИЮ WCF и ASP.NET AJAX, за исключением поддержки, необходимой для кодирования нотация объектов JavaScript (JSON). Различные типы кодирования, включая JSON, включены с помощью WebMessageEncodingElement или с помощью соответственно настроенного WebHttpBinding. WebScriptEnablingBehaviorПоведение реализует класс IEndpointBehavior и наследует от WebHttpBehavior , что позволяет реализовать более общую модель веб-программирования для служб WCF, предоставляя конечные точки, не относящиеся к SOAP.
В частности, WebScriptEnablingBehavior:
Включает модель программирования HTTP, включая диспетчер для операций на основе суффикса URL-адреса, поддержку для выбора HTTP-команды (POST или GET) и элемент управления длительности кэширования HTTP. Дополнительные сведения о модели программирования HTTP см. в разделе Общие сведения о модели программирования WCF Web HTTP. Обратите внимание, что HTTP-командой по умолчанию при использовании этого поведения является POST.
Включает правильное средство форматирования для сообщений запросов и ответов каждой операции — например, поддержку для параметров URL-адреса.
Включает конечную точку прокси JavaScript.
Чтобы вызвать службу WCF из клиента ASP.NET AJAX, необходимо настроить службу с WebHttpBinding привязкой и WebScriptEnablingBehavior добавить ее в коллекцию поведения конечной точки. Это можно сделать в конфигурации, добавив WebScriptEnablingElement или без использования конфигурации, активируя конечную точку AJAX с помощью WebScriptServiceHostFactory вместо фабрики по умолчанию в @ServiceHost директиве в файле SVC.
Дополнительные сведения о различных способах включения службы WCF для реагирования на клиентов ASP.NET AJAX см. в разделе Создание служб WCF для ASP.NET AJAX.
Конструкторы
WebScriptEnablingBehavior() |
Инициализирует новый экземпляр класса WebScriptEnablingBehavior. |
Свойства
AutomaticFormatSelectionEnabled |
Возвращает или задает значение, определяющее, включен ли автоматический выбор формата. |
AutomaticFormatSelectionEnabled |
Возвращает или задает значение, определяющее, включен ли автоматический выбор формата. (Унаследовано от WebHttpBehavior) |
DefaultBodyStyle |
Возвращает или задает основной стиль сообщения по умолчанию. |
DefaultOutgoingRequestFormat |
Возвращает или задает исходящий формат сообщения по умолчанию. |
DefaultOutgoingResponseFormat |
Получает или задает формат исходящего сообщения ответа по умолчанию. |
FaultExceptionEnabled |
Возвращает или задает флаг, указывающий, будет ли создаваться исключение FaultException при возникновении внутренней ошибки сервера (код состояния HTTP: 500). |
FaultExceptionEnabled |
Возвращает или задает флаг, указывающий, будет ли создаваться исключение FaultException при возникновении внутренней ошибки сервера (код состояния HTTP: 500). (Унаследовано от WebHttpBehavior) |
HelpEnabled |
Возвращает или задает значение, определяющее, будет ли включена страница справки REST WCF. |
HelpEnabled |
Возвращает или задает значение, определяющее, будет ли включена страница справки WCF. (Унаследовано от WebHttpBehavior) |
JavascriptCallbackParameterName |
Возвращает или задает имя параметра обратного вызова JavaScript. (Унаследовано от WebHttpBehavior) |
Методы
AddBindingParameters(ServiceEndpoint, BindingParameterCollection) |
Реализует метод AddBindingParameters(ServiceEndpoint, BindingParameterCollection) для передачи пользовательских данных во время выполнения для поддержки пользовательского поведения. (Унаследовано от WebHttpBehavior) |
AddClientErrorInspector(ServiceEndpoint, ClientRuntime) |
Добавляет инспектор ошибок клиента в указанную конечную точку службы. (Унаследовано от WebHttpBehavior) |
AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher) |
Переопределите этот метод, чтобы изменить способ обработки ошибок, возникающих в работе службы. (Унаследовано от WebHttpBehavior) |
ApplyClientBehavior(ServiceEndpoint, ClientRuntime) |
Применяет поведение к клиенту на протяжении всей конечной точки. |
ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) |
Применяет поведение к конечной точке службы. |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetOperationSelector(ServiceEndpoint) |
Создает новый объект WebHttpDispatchOperationSelector. (Унаследовано от WebHttpBehavior) |
GetQueryStringConverter(OperationDescription) |
Возвращает преобразователь строки запроса. (Унаследовано от WebHttpBehavior) |
GetReplyClientFormatter(OperationDescription, ServiceEndpoint) |
Возвращает модуль форматирования ответа в клиенте для заданной конечной точки и операции службы. (Унаследовано от WebHttpBehavior) |
GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint) |
Возвращает модуль форматирования ответа в службе для заданной конечной точки и операции службы. (Унаследовано от WebHttpBehavior) |
GetRequestClientFormatter(OperationDescription, ServiceEndpoint) |
Возвращает модуль форматирования запроса в клиенте для заданной операции службы и конечной точки. (Унаследовано от WebHttpBehavior) |
GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint) |
Возвращает модуль форматирования запроса в службе для данной операции службы и конечной точки службы. (Унаследовано от WebHttpBehavior) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Validate(ServiceEndpoint) |
Подтверждает, что конечная точка отвечает требованиям, позволяющим ей функционировать как конечной точке ASP.NET AJAX. |
ValidateBinding(ServiceEndpoint) |
Обеспечивает правильность привязки для модели веб-программирования WCF. (Унаследовано от WebHttpBehavior) |
ValidateOperation(OperationDescription) | (Унаследовано от WebHttpBehavior) |