BindingElement Klas

Definitie

public ref class BindingElement abstract

public abstract class BindingElement

type BindingElement = class

Public MustInherit Class BindingElement

Overname

Object

BindingElement

Afgeleid

System.ServiceModel.Channels.CompositeDuplexBindingElement

System.ServiceModel.Channels.ContextBindingElement

System.ServiceModel.Channels.HttpCookieContainerBindingElement

System.ServiceModel.Channels.MessageEncodingBindingElement

System.ServiceModel.Channels.OneWayBindingElement

Meer…

Voorbeelden

In het volgende voorbeeld ziet u hoe u een transportbindingselement toevoegt aan een aangepaste binding en vervolgens een kanaallistener bouwt die binnenkomende berichten kan accepteren.

CustomBinding binding = new CustomBinding();
binding.Elements.Add(new HttpTransportBindingElement());
BindingParameterCollection paramCollection = new BindingParameterCollection();
IChannelListener<IReplyChannel> listener = binding.BuildChannelListener<IReplyChannel>
    (new Uri("http://localhost:8000/ChannelApp"), paramCollection);

listener.Open();
IReplyChannel channel = listener.AcceptChannel();
Console.WriteLine("Listening for messages");
channel.Open();
RequestContext request = channel.ReceiveRequest();
Message msg = request.RequestMessage;
Console.WriteLine("Message Received");
Console.WriteLine("Message Action: {0}", msg.Headers.Action);

if (msg.Headers.Action == "hello")
{
    Message reply = Message.CreateMessage(MessageVersion.Default, "wcf");
    request.Reply(reply);
}

msg.Close();
channel.Close();
listener.Close();

Dim binding As New CustomBinding()
binding.Elements.Add(New HttpTransportBindingElement())
Dim paramCollection As New BindingParameterCollection()

Dim listener As IChannelListener(Of IReplyChannel)
listener = binding.BuildChannelListener(Of IReplyChannel)(New Uri("http://localhost/channelApp"), paramCollection)

listener.Open()
Dim channel As IReplyChannel = listener.AcceptChannel()
Console.WriteLine("Listening for messages")
channel.Open()
Dim request As RequestContext = channel.ReceiveRequest()
Dim msg As Message = request.RequestMessage
Console.WriteLine("Message Received")
Console.WriteLine("Message Action: {0}", msg.Headers.Action)

If (msg.Headers.Action = "hello") Then

    Dim reply As Message = Message.CreateMessage(MessageVersion.Default, "wcf")
    request.Reply(reply)
End If

msg.Close()
channel.Close()
listener.Close()

Opmerkingen

Een binding bestaat uit een geordende set bindingselementen die overnemen van deze abstracte basisklasse. De TransportBindingElement klasse neemt over van de BindingElement klasse.

Het maken van een bindings- en bindingselement voor uw transport is optioneel als u alleen het kanaalmodel gebruikt. Het is mogelijk om alles te doen wat u nodig hebt via de kanaalfactory en listener zolang ze openbaar worden gemaakt.

Het servicemodel Windows Communication Foundation (WCF) maakt gebruik van een fabriekspatroon waarin de binding wordt gebruikt om de kanaalstack te maken. Als u het WCF-servicemodel wilt gebruiken, is het gebruik van een transportbindingselement vereist. Het plaatsen van dit bindingselement in een binding is een goede gewoonte omdat hiermee de vereiste voor gebruikers wordt verwijderd om hun eigen aangepaste binding voor uw transport te maken. U kunt het beste zowel een bindings- als bindingselement maken en de kanaalfactory en listener in de assembly verbergen.

Aan de verzendzijde wordt een binding gebruikt om een IChannelFactory, die op zijn beurt een kanaalstack bouwt en een verwijzing naar het bovenste kanaal in de stack retourneert. De toepassing kan dit kanaal vervolgens gebruiken om berichten te verzenden.

Op dezelfde manier wordt aan de ontvangende zijde een binding gebruikt om een IChannelListenerbinding te bouwen, die luistert naar binnenkomende berichten. Het IChannelListener biedt berichten aan de luistertoepassing door kanaalstacks te maken en de toepassing een verwijzing naar het bovenste kanaal te geven. De toepassing gebruikt dit kanaal vervolgens om binnenkomende berichten te ontvangen.