WebHttpRelayBinding Classe
TOC
Recolher sumário
Expandir sumário
Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe WebHttpRelayBinding

 

Uma associação usada para configurar pontos de extremidade para serviços da Web que são expostos por meio de solicitações HTTP em vez de mensagens SOAP.

Namespace:   Microsoft.ServiceBus
Assembly:  Microsoft.ServiceBus (em Microsoft.ServiceBus.dll)

System.Object
  System.ServiceModel.Channels.Binding
    Microsoft.ServiceBus.WebHttpRelayBinding

public class WebHttpRelayBinding : Binding, IBindingRuntimePreferences

NomeDescrição
System_CAPS_pubmethodWebHttpRelayBinding()

Inicializa uma nova instância de WebHttpRelayBinding classe.

System_CAPS_pubmethodWebHttpRelayBinding(EndToEndWebHttpSecurityMode, RelayClientAuthenticationType)

Inicializa uma nova instância do WebHttpRelayBinding classe usando o tipo de autenticação de cliente de retransmissão e de segurança especificado.

System_CAPS_pubmethodWebHttpRelayBinding(String)

Inicializa uma nova instância de WebHttpRelayBinding classe usando o nome de configuração especificado.

NomeDescrição
System_CAPS_pubpropertyAllowCookies

Obtém ou define um valor que especifica se os cookies são permitidos nas mensagens enviadas por meio de WebHttpRelayBinding.

System_CAPS_pubpropertyCloseTimeout

(herdado de Binding.)

System_CAPS_pubpropertyContentTypeMapper

Obtém ou define o mapeador de tipo de conteúdo.

System_CAPS_pubpropertyEnvelopeVersion

Obtém a versão de envelope SOAP.

System_CAPS_pubpropertyHostNameComparisonMode

Obtém ou define o modo de comparação usado no nome do host.

System_CAPS_pubpropertyIsDynamic

Obtém ou define se a associação de retransmissão é dinâmica.

System_CAPS_pubpropertyMaxBufferPoolSize

Obtém ou define o tamanho do pool de buffer máximo usado pelo transporte.

System_CAPS_pubpropertyMaxBufferSize

Obtém ou define o tamanho de buffer máximo suportado pelo transporte.

System_CAPS_pubpropertyMaxReceivedMessageSize

Obtém ou define o tamanho de mensagem máximo permitido que pode ser recebido.

System_CAPS_pubpropertyMessageVersion

(herdado de Binding.)

System_CAPS_pubpropertyName

(herdado de Binding.)

System_CAPS_pubpropertyNamespace

(herdado de Binding.)

System_CAPS_pubpropertyOpenTimeout

(herdado de Binding.)

System_CAPS_pubpropertyProxyAddress

Obtém ou define um URI que contém o endereço do proxy a ser usado para solicitações HTTP.

System_CAPS_pubpropertyReaderQuotas

Obtém ou define cotas do leitor de xml nas mensagens processadas.

System_CAPS_pubpropertyReceiveTimeout

(herdado de Binding.)

System_CAPS_pubpropertyScheme

Obtém o esquema para os pontos de extremidade usados com a associação.(Substitui Binding.Scheme.)

System_CAPS_pubpropertySecurity

Obtém as configurações de segurança para a instância atual.

System_CAPS_pubpropertySendTimeout

(herdado de Binding.)

System_CAPS_pubpropertyTransferMode

Obtém ou define o modo de transferência.

System_CAPS_pubpropertyUseDefaultWebProxy

Obtém ou define um valor que indica se as configurações de proxy de todo o computador são usadas em vez de configurações específicas do usuário.

System_CAPS_pubpropertyWriteEncoding

Obtém ou define a codificação de caracteres que é usado para escrever o texto da mensagem.

NomeDescrição
System_CAPS_pubmethodBuildChannelFactory<TChannel>(BindingParameterCollection)

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelFactory<TChannel>(Object[])

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelListener<TChannel>(BindingParameterCollection)

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Object[])

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, BindingParameterCollection)

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, Object[])

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

(herdado de Binding.)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, String, Object[])

(herdado de Binding.)

System_CAPS_pubmethodCanBuildChannelFactory<TChannel>(BindingParameterCollection)

(herdado de Binding.)

System_CAPS_pubmethodCanBuildChannelFactory<TChannel>(Object[])

(herdado de Binding.)

System_CAPS_pubmethodCanBuildChannelListener<TChannel>(BindingParameterCollection)

(herdado de Binding.)

System_CAPS_pubmethodCanBuildChannelListener<TChannel>(Object[])

(herdado de Binding.)

System_CAPS_pubmethodCreateBindingElements()

Cria uma coleção com elementos de associação para a associação.(Substitui Binding.CreateBindingElements().)

System_CAPS_pubmethodEquals(Object)

(herdado de Object.)

System_CAPS_protmethodFinalize()

(herdado de Object.)

System_CAPS_pubmethodGetHashCode()

(herdado de Object.)

System_CAPS_pubmethodGetProperty<T>(BindingParameterCollection)

(herdado de Binding.)

System_CAPS_pubmethodGetType()

(herdado de Object.)

System_CAPS_protmethodMemberwiseClone()

(herdado de Object.)

System_CAPS_pubmethodToString()

(herdado de Object.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingRuntimePreferences.ReceiveSynchronously

Obtém um valor que indica se as solicitações de entrada são manipuladas de forma síncrona ou assíncrona.

O WebHttpRelayBinding é ideal para a integração de clientes não WCF simples com pontos de extremidade do barramento de serviço porque ela expõe pontos de extremidade REST para serviços da web. Portanto, qualquer cliente capaz de comunicação RESTful pode interagir com serviços (ouvintes) hospedados no barramento de serviço por meio de WebHttpRelayBinding. No entanto, se mais sofisticados recursos de segurança e confiabilidade são necessários, em seguida, WS2007HttpRelayBinding seria mais apropriado.

O exemplo a seguir mostra como definir e usar WebHttpRelayBinding em um arquivo de configuração do aplicativo. A associação neste exemplo possui autenticação de cliente desativada, que significa que o cliente não é necessário para apresentar um token de segurança para o barramento de serviço.

<system.serviceModel>
  <bindings>
    <!-- Application Binding -->
    <webHttpRelayBinding>
      <binding name="customBinding">
        <!-- Turn off client authentication so that client does not need to present credential through browser or fiddler -->
        <security relayClientAuthenticationType="None" />
      </binding>
    </webHttpRelayBinding>
  </bindings>

  <services>
    <!-- Application Service -->
    <service name="Microsoft.ServiceBus.Samples.ImageService">
      <endpoint name="RelayEndpoint"
                contract="Microsoft.ServiceBus.Samples.IImageContract"
                binding="webHttpRelayBinding"
                bindingConfiguration="customBinding"
                behaviorConfiguration="sharedSecretClientCredentials"
                address="" />
    </service>
  </services>

  <behaviors>
    <!-- Specify service and endpoint behaviors here. -->
  </behaviors>

</system.serviceModel>

O exemplo a seguir ilustra o uso do WebHttpRelayBinding programaticamente com configurações personalizadas. A ligação personalizada tem autenticação de cliente desativada, que significa que o cliente não é necessário para apresentar um token de segurança para o barramento de serviço. Este exemplo é uma versão modificada do WebHttp exemplo, que especifica a associação para o ponto de extremidade de serviço por meio de programação, em vez de especificá-lo no arquivo de configuração do aplicativo.

O exemplo começa especificando as credenciais que o aplicativo de serviço deve enviar para o barramento de serviço, criando um comportamento de ponto de extremidade. Em seguida, ele cria a associação, o endereço do serviço e inicia o host de serviço web. Depois de iniciar o serviço da web, o usuário pode usar um navegador para obter a imagem que expõe o serviço na URL especificada.

// Configure the credentials for the service and client endpoints through an endpoint behavior.
TransportClientEndpointBehavior relayCredentials = new TransportClientEndpointBehavior();
relayCredentials.TokenProvider = 
  TokenProvider.CreateSharedAccessSignatureTokenProvider(keyName, key);

// Create the binding with custom settings.
WebHttpRelayBinding binding = new WebHttpRelayBinding();
binding.Security.RelayClientAuthenticationType = RelayClientAuthenticationType.None;

// Get the service URI.
Uri address = ServiceBusEnvironment.CreateServiceUri("https", serviceNamespace, "Image");

// Create the web service host.
WebServiceHost host = new WebServiceHost(typeof(ImageService), address);
// Add the service endpoint with the WebHttpRelayBinding binding.
host.AddServiceEndpoint(typeof(IImageContract), binding, address);
// Add the credentials through the endpoint behavior.
host.Description.Endpoints[0].Behaviors.Add(relayCredentials);
// Start the service.
host.Open();

Console.WriteLine("Copy the following address into a browser to see the image: ");
Console.WriteLine(address + "GetImage");
Console.WriteLine();
Console.WriteLine("Press [Enter] to exit");
Console.ReadLine();

host.Close();

Qualquer estático público (Compartilhado no Visual Basic) membros desde tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao topo
Mostrar:
© 2016 Microsoft