CustomBinding Klass

Definition

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

Arv

Object

Binding

CustomBinding

Attribut

ContentPropertyAttribute

Exempel

I följande exempel visas hur du skapar ett CustomBinding objekt med hjälp av en ReliableSessionBindingElement och en 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

Kommentarer

Använd en anpassad bindning när en av de systembaserade bindningarna inte uppfyller kraven för din tjänst. En anpassad bindning kan till exempel användas för att aktivera användning av en ny transport eller en ny kodare vid en tjänstslutpunkt.

En anpassad bindning skapas med hjälp av en av CustomBinding de från en samling bindningselement som är "staplade" i en viss ordning:

• Längst upp finns ett valfritt TransactionFlowBindingElement alternativ som tillåter flödande transaktioner.

• Nästa är ett valfritt ReliableSessionBindingElement som tillhandahåller en sessions- och beställningsmekanism enligt definitionen i WS-ReliableMessaging-specifikationen. Denna uppfattning om en session kan korsa SOAP och transportförmedlare.

• Nästa är ett valfritt säkerhetsbindningselement som tillhandahåller säkerhetsfunktioner som auktorisering, autentisering, skydd och konfidentialitet. Följande säkerhetsbindningselement tillhandahålls av Windows Communication Foundation (WCF):

  • SecurityBindingElement

  • AsymmetricSecurityBindingElement

  • SymmetricSecurityBindingElement

  • TransportSecurityBindingElement

• Nästa steg är de valfria meddelandemönster som anges av bindningselement:

• CompositeDuplexBindingElement

• Härnäst är de valfria transportuppgraderingar/hjälpelementen som binder element:

  • PnrpPeerResolverBindingElement

  • SslStreamSecurityBindingElement

  • WindowsStreamSecurityBindingElement

• Nästa är ett obligatoriskt meddelandekodningsbindningselement. Du kan använda din egen transport eller använda någon av följande meddelandekodningsbindningar:

  • TextMessageEncodingBindingElement

  • BinaryMessageEncodingBindingElement

  • MtomMessageEncodingBindingElement

• Längst ned finns ett obligatoriskt transportelement. Du kan använda din egen transport eller använda något av de transportbindningselement som tillhandahålls av Windows Communication Foundation (WCF):

  • TcpTransportBindingElement

  • NamedPipeTransportBindingElement

  • HttpTransportBindingElement

  • HttpsTransportBindingElement

  • MsmqTransportBindingElement

  • MsmqIntegrationBindingElement

  • PeerTransportBindingElement

I följande tabell sammanfattas alternativen för varje lager.

Dessutom kan du definiera dina egna bindningselement och infoga dem mellan något av de föregående definierade lagren.

En diskussion om hur du använder en anpassad bindning för att ändra en bindning som tillhandahålls av systemet finns i Så här: Anpassa en System-Provided-bindning.