WebScriptEnablingBehavior Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece suporte para o comportamento que permite que pontos de extremidade Windows Communication Foundation (WCF) recebam solicitações HTTP de um cliente do AJAX ASP.NET baseado em navegador. Essa classe não pode ser herdada.
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- Herança
Comentários
Quando aplicado a um ponto de extremidade, o comportamento WebScriptEnablingBehavior habilita a integração WCF e ASP.NET AJAX, exceto pelo suporte necessário para codificação JSON (JavaScript Object Notation). Vários tipos de codificação, incluindo JSON, são habilitados pelo WebMessageEncodingElement ou por um configurado WebHttpBindingadequadamente. O WebScriptEnablingBehavior comportamento implementa e IEndpointBehavior herda de WebHttpBehavior, o que permite o modelo de programação Web mais geral para serviços WCF expondo pontos de extremidade não SOAP.
Especificamente, o WebScriptEnablingBehavior:
Habilita o modelo de programação HTTP, incluindo expedição para operações com base em um sufixo de URL, suporte para seleção de verbo HTTP (POST ou GET) e controle de duração do cache HTTP. Para obter mais informações sobre o modelo de programação HTTP, consulte a visão geral do modelo de programação HTTP da Web do WCF. Observe que o verbo HTTP padrão é POST ao usar esse comportamento.
Habilita o formatador correto para as mensagens de solicitação e resposta de cada operação, por exemplo, suporte para parâmetros de URL.
Habilita o ponto de extremidade do Proxy JavaScript.
Para chamar um serviço WCF de um cliente ASP.NET AJAX, o serviço deve ser configurado com a associação WebHttpBinding e o WebScriptEnablingBehavior deve ser adicionado à coleção de comportamento do ponto de extremidade. Isso pode ser feito na configuração adicionando ou sem usar a WebScriptEnablingElement configuração ativando o ponto de extremidade AJAX com a WebScriptServiceHostFactory fábrica padrão na diretiva @ServiceHost no arquivo .svc.
Para obter mais informações sobre diferentes maneiras de permitir que um serviço WCF responda a clientes ASP.NET AJAX, consulte Criating WCF Services for ASP.NET AJAX.
Construtores
| Nome | Description |
|---|---|
| WebScriptEnablingBehavior() |
Inicializa uma nova instância da classe WebScriptEnablingBehavior. |
Propriedades
| Nome | Description |
|---|---|
| AutomaticFormatSelectionEnabled |
Obtém ou define um valor que determina se a seleção automática de formato está habilitada. |
| DefaultBodyStyle |
Obtém ou define o estilo do corpo da mensagem padrão. |
| DefaultOutgoingRequestFormat |
Obtém ou define o formato de mensagem de solicitação de saída padrão. |
| DefaultOutgoingResponseFormat |
Obtém ou define o formato de mensagem de resposta de saída padrão. |
| FaultExceptionEnabled |
Obtém ou define o sinalizador que especifica se uma FaultException é gerada quando ocorre um erro interno do servidor (código de status HTTP: 500). |
| HelpEnabled |
Obtém ou define um valor que determina se a página de Ajuda REST do WCF está habilitada. |
| JavascriptCallbackParameterName |
Obtém ou define o nome do parâmetro de retorno de chamada JavaScript. (Herdado de WebHttpBehavior) |
Métodos
| Nome | Description |
|---|---|
| AddBindingParameters(ServiceEndpoint, BindingParameterCollection) |
Implementa o AddBindingParameters(ServiceEndpoint, BindingParameterCollection) método para passar dados em runtime para associações para dar suporte a comportamentos personalizados. (Herdado de WebHttpBehavior) |
| AddClientErrorInspector(ServiceEndpoint, ClientRuntime) |
Adiciona um inspetor de erros do cliente ao ponto de extremidade de serviço especificado. (Herdado de WebHttpBehavior) |
| AddServerErrorHandlers(ServiceEndpoint, EndpointDispatcher) |
Substitua esse método para alterar a maneira como os erros que ocorrem no serviço são tratados. (Herdado de WebHttpBehavior) |
| ApplyClientBehavior(ServiceEndpoint, ClientRuntime) |
Aplica o comportamento ao cliente em um ponto de extremidade. |
| ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) |
Aplica o comportamento ao ponto de extremidade de serviço. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetOperationSelector(ServiceEndpoint) |
Cria um novo objeto WebHttpDispatchOperationSelector. (Herdado de WebHttpBehavior) |
| GetQueryStringConverter(OperationDescription) |
Obtém o conversor de cadeia de caracteres de consulta. (Herdado de WebHttpBehavior) |
| GetReplyClientFormatter(OperationDescription, ServiceEndpoint) |
Obtém o formatador de resposta no cliente para o ponto de extremidade e a operação de serviço especificados. (Herdado de WebHttpBehavior) |
| GetReplyDispatchFormatter(OperationDescription, ServiceEndpoint) |
Obtém o formatador de resposta no serviço para o ponto de extremidade e a operação de serviço especificados. (Herdado de WebHttpBehavior) |
| GetRequestClientFormatter(OperationDescription, ServiceEndpoint) |
Obtém o formatador de solicitação no cliente para a operação de serviço e o ponto de extremidade especificados. (Herdado de WebHttpBehavior) |
| GetRequestDispatchFormatter(OperationDescription, ServiceEndpoint) |
Obtém o formatador de solicitação no serviço para a operação de serviço e o ponto de extremidade de serviço especificados. (Herdado de WebHttpBehavior) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| Validate(ServiceEndpoint) |
Confirma que o ponto de extremidade atende aos requisitos que permitem que ele funcione como um ponto de extremidade AJAX ASP.NET. |
| ValidateBinding(ServiceEndpoint) |
Garante que a associação seja válida para uso com o modelo de programação da Web do WCF. (Herdado de WebHttpBehavior) |