HttpTransportBindingElement Classe

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Http.dll

Pacote:

System.ServiceModel.Http v8.0.0

Origem:

HttpTransportBindingElement.cs

Representa o elemento de associação usado para especificar um transporte HTTP para transmissão de mensagens.

public ref class HttpTransportBindingElement : System::ServiceModel::Channels::TransportBindingElement

public class HttpTransportBindingElement : System.ServiceModel.Channels.TransportBindingElement

type HttpTransportBindingElement = class
    inherit TransportBindingElement

Public Class HttpTransportBindingElement
Inherits TransportBindingElement

Herança

Object

BindingElement

TransportBindingElement

HttpTransportBindingElement

Derivado

System.ServiceModel.Channels.HttpsTransportBindingElement

Exemplos

O código a seguir mostra como usar imperativamente o HttpTransportBindingElement.

Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");

// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    // Create a custom binding that contains two binding elements.
    ReliableSessionBindingElement reliableSession = new ReliableSessionBindingElement();
    reliableSession.Ordered = true;

    HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous;
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;

    CustomBinding binding = new CustomBinding(reliableSession, httpTransport);

    // Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, "");

    // Add a MEX endpoint.
    ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
    smb.HttpGetEnabled = true;
    smb.HttpGetUrl = new Uri("http://localhost:8001/servicemodelsamples");
    serviceHost.Description.Behaviors.Add(smb);

    // Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();

    // Close the ServiceHostBase to shutdown the service.
    serviceHost.Close();
}

Dim baseAddress As New Uri("http://localhost:8000/servicemodelsamples/service")

' Create a ServiceHost for the CalculatorService type and provide the base address.
Using serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
    ' Create a custom binding that contains two binding elements.
    Dim reliableSession As New ReliableSessionBindingElement()
    reliableSession.Ordered = True

    Dim httpTransport As New HttpTransportBindingElement()
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard

    Dim binding As New CustomBinding(reliableSession, httpTransport)

    ' Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, "")

    ' Add a MEX endpoint.
    Dim smb As New ServiceMetadataBehavior()
    smb.HttpGetEnabled = True
    smb.HttpGetUrl = New Uri("http://localhost:8001/servicemodelsamples")
    serviceHost.Description.Behaviors.Add(smb)

    ' Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open()

    ' The service can now be accessed.
    Console.WriteLine("The service is ready.")
    Console.WriteLine("Press <ENTER> to terminate service.")
    Console.WriteLine()
    Console.ReadLine()

    ' Close the ServiceHostBase to shutdown the service.
    serviceHost.Close()
End Using

HttpTransportBindingElement também pode ser usado em um arquivo de configuração, conforme mostrado na configuração a seguir.

<bindings>  
  <customBinding>  
    <binding name="Binding1">  
      <reliableSession acknowledgementInterval="00:00:00.2000000" enableFlowControl="true"  
                        maxTransferWindowSize="32" inactivityTimeout="00:10:00" maxPendingChannels="128"  
                        maxRetryCount="8" ordered="true" />  
      <security mode="None"/>  
      <httpTransport authenticationScheme="Anonymous" bypassProxyOnLocal="false"  
                    hostNameComparisonMode="StrongWildcard"   
                    proxyAuthenticationScheme="Anonymous" realm=""   
                    useDefaultWebProxy="true" />  
    </binding>  
  </customBinding>  
</bindings>  

Comentários

A HttpTransportBindingElement classe é o ponto de partida para criar uma associação personalizada que implementa o protocolo de transporte HTTP. HTTP é o transporte primário usado para fins de interoperabilidade. Esse transporte tem suporte do WCF (Windows Communication Foundation) para garantir a interoperabilidade com outras pilhas de serviços Web não WCF.

O modelo de serviço WCF usa essa classe para criar objetos de fábrica que implementam as IChannelFactory interfaces e IChannelListener . Esses objetos de fábrica, por sua vez, criam os canais e ouvintes que transmitem mensagens SOAP usando o protocolo HTTP.

Você configura as fábricas que essa classe cria definindo suas propriedades, como AuthenticationScheme, HostNameComparisonModee MaxBufferSize.

Você também pode definir propriedades na classe base, TransportBindingElement, como ManualAddressing, MaxReceivedMessageSizee MaxBufferPoolSize. Para obter uma lista completa de propriedades, consulte TransportBindingElement.

Construtores

HttpTransportBindingElement()	Inicializa uma nova instância da classe HttpTransportBindingElement.
HttpTransportBindingElement(HttpTransportBindingElement)	Inicializa uma nova instância da classe HttpTransportBindingElement usando outro elemento de associação.

Propriedades

AllowCookies	Obtém ou define um valor que indica se o cliente aceita cookies e propaga-os em solicitações futuras.
AuthenticationScheme	Obtém ou define o esquema de autenticação usado para autenticar solicitações de cliente sendo processadas por um ouvinte HTTP.
BypassProxyOnLocal	Obtém ou define um valor que indica se os proxies são ignorados para endereços locais.
DecompressionEnabled	Obtém ou define se o processo para retornar dados de mensagem compactados para o tamanho e o formato originais está habilitado.
ExtendedProtectionPolicy	Obtém ou define o valor da política de segurança estendida usada pelo servidor para validar as conexões de cliente recebidas.
HostNameComparisonMode	Obtém ou define um valor que indica se o nome do host é usado para alcançar o serviço ao fazer correspondência no URI.
KeepAliveEnabled	Obtém ou define um valor que indica se será feita uma conexão persistente com um ponto de extremidade de serviço.
ManualAddressing	Obtém ou define um valor que indica se o endereçamento manual da mensagem é necessário. (Herdado de TransportBindingElement)
MaxBufferPoolSize	Obtém ou define o tamanho máximo, em bytes, de qualquer pool de buffer usado pelo transporte. (Herdado de TransportBindingElement)
MaxBufferSize	Obtém ou define o tamanho máximo do buffer a ser usado. Para mensagens em buffer, esse valor é o mesmo que MaxReceivedMessageSize. Para mensagens transmitidas, esse valor é o tamanho máximo dos cabeçalhos SOAP, que devem ser lidos no modo de buffer.
MaxPendingAccepts	Obtém ou define o número máximo de conexões que o serviço pode aceitar simultaneamente.
MaxReceivedMessageSize	Obtém ou define o tamanho de mensagem máximo permitido, em bytes, que pode ser recebido. (Herdado de TransportBindingElement)
MessageHandlerFactory	Obtém ou define a fábrica de manipulador de mensagens de transporte HTTP.
Proxy	Representa o elemento de associação usado para especificar um transporte HTTP para transmissão de mensagens.
ProxyAddress	Obtém ou define um URI que contém o endereço do proxy a ser usado para solicitações HTTP.
ProxyAuthenticationScheme	Obtém ou define o esquema de autenticação usado para autenticar solicitações de cliente processadas por um proxy HTTP.
Realm	Obtém ou define o realm de autenticação.
RequestInitializationTimeout	Obtém ou define o tempo limite da inicialização solicitada.
Scheme	Obtém o esquema do URI para o transporte.
TransferMode	Obtém ou define o modo de transferência.
UnsafeConnectionNtlmAuthentication	Obtém ou define um valor que indica se o Compartilhamento de Conexão Não Segura está habilitado no servidor. Se estiver habilitado, a autenticação NTLM será executada uma vez em cada conexão TCP.
UseDefaultWebProxy	Obtém ou define um valor que indica se as configurações de proxy para todo o computador são usadas em vez de configurações específicas do usuário.
WebSocketSettings	Obtém ou define a configuração de soquete da Web do elemento de associação.

Métodos

BuildChannelFactory<TChannel>(BindingContext)	Cria uma fábrica de canais que pode ser usada para criar um canal.
BuildChannelListener<TChannel>(BindingContext)	Inicializa um ouvinte de canais para aceitar canais de um tipo especificado do contexto de associação. (Herdado de BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Determina se uma fábrica de canais do tipo especificado pode ser criada.
CanBuildChannelListener<TChannel>(BindingContext)	Retorna um valor que indica se o elemento de associação pode criar um ouvinte para um tipo de canal específico. (Herdado de BindingElement)
Clone()	Cria uma nova instância que é uma cópia do elemento de associação atual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetProperty<T>(BindingContext)	Obtém uma propriedade do BindingContext especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)