CustomBinding Classe

Definição

public ref class CustomBinding : System::ServiceModel::Channels::Binding

public class CustomBinding : System.ServiceModel.Channels.Binding

[System.Windows.Markup.ContentProperty("Elements")]
public class CustomBinding : System.ServiceModel.Channels.Binding

type CustomBinding = class
    inherit Binding

[<System.Windows.Markup.ContentProperty("Elements")>]
type CustomBinding = class
    inherit Binding

Public Class CustomBinding
Inherits Binding

Herança

Object

Binding

CustomBinding

Atributos

ContentPropertyAttribute

Exemplos

O exemplo seguinte mostra como criar um CustomBinding objeto usando um ReliableSessionBindingElement e um 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

Observações

Use uma ligação personalizada quando uma das ligações fornecidas pelo sistema não cumprir os requisitos do seu serviço. Uma ligação personalizada poderia ser usada, por exemplo, para permitir a utilização de um novo transporte ou de um novo codificador num endpoint de serviço.

Uma ligação personalizada é construída usando um dos CustomBinding elementos de ligação de uma coleção de elementos de ligação que são "empilhados" numa ordem específica:

• No topo está uma opção TransactionFlowBindingElement opcional que permite transações fluídas.

• De seguida, há um opcional ReliableSessionBindingElement que fornece um mecanismo de sessão e ordenação conforme definido na especificação WS-ReliableMessaging. Esta noção de sessão pode cruzar SOAP e intermediários de transporte.

• A seguir há um elemento opcional de vinculação de segurança que fornece funcionalidades de segurança como autorização, autenticação, proteção e confidencialidade. Os seguintes elementos de ligação de segurança são fornecidos pela Windows Communication Foundation (WCF):

  • SecurityBindingElement

  • AsymmetricSecurityBindingElement

  • SymmetricSecurityBindingElement

  • TransportSecurityBindingElement

• Seguem-se os padrões de mensagens opcionais especificados pelos elementos de ligação:

• CompositeDuplexBindingElement

• A seguir vêm as melhorias opcionais de transporte/elementos de ligação de ajudantes:

  • PnrpPeerResolverBindingElement

  • SslStreamSecurityBindingElement

  • WindowsStreamSecurityBindingElement

• Em seguida, é necessário um elemento de vinculação de codificação de mensagem obrigatório. Pode usar o seu próprio transporte ou usar uma das seguintes ligações de codificação de mensagens:

  • TextMessageEncodingBindingElement

  • BinaryMessageEncodingBindingElement

  • MtomMessageEncodingBindingElement

• Na parte inferior está um elemento de transporte necessário. Pode usar o seu próprio transporte ou utilizar um dos elementos de ligação de transporte fornecidos pela Windows Communication Foundation (WCF):

  • TcpTransportBindingElement

  • NamedPipeTransportBindingElement

  • HttpTransportBindingElement

  • HttpsTransportBindingElement

  • MsmqTransportBindingElement

  • MsmqIntegrationBindingElement

  • PeerTransportBindingElement

A tabela a seguir resume as opções para cada camada.

Além disso, você pode definir seus próprios elementos de ligação e inseri-los entre qualquer uma das camadas definidas anteriormente.

Para uma discussão sobre como usar uma ligação personalizada para modificar uma ligação fornecida pelo sistema, veja Como: Personalizar uma Ligação System-Provided.