BindingElement Klass

Definition

public ref class BindingElement abstract

public abstract class BindingElement

type BindingElement = class

Public MustInherit Class BindingElement

Arv

Object

BindingElement

Härledda

System.ServiceModel.Channels.CompositeDuplexBindingElement

System.ServiceModel.Channels.ContextBindingElement

System.ServiceModel.Channels.HttpCookieContainerBindingElement

System.ServiceModel.Channels.MessageEncodingBindingElement

System.ServiceModel.Channels.OneWayBindingElement

Mer…

Exempel

I följande exempel visas hur du lägger till ett transportbindningselement i en anpassad bindning och sedan skapar en kanallyssnare som kan acceptera inkommande meddelanden.

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()

Kommentarer

En bindning består av en ordnad uppsättning bindningselement som ärver från den här abstrakta basklassen. Klassen TransportBindingElement ärver från BindingElement klassen.

Det är valfritt att skapa ett bindnings- och bindningselement för din transport om du bara använder kanalmodellen. Det är möjligt att göra allt du behöver via kanalfabriken och lyssnaren så länge de offentliggörs.

Tjänstmodellen Windows Communication Foundation (WCF) använder ett fabriksmönster där bindningen används för att skapa kanalstacken. Om du vill använda WCF-tjänstmodellen måste du använda ett transportbindningselement. Att placera det här bindningselementet i en bindning är en bra idé eftersom det tar bort kravet på att användarna ska skapa en egen anpassad bindning för din transport. Det är bäst att skapa både ett bindnings- och bindningselement och dölja kanalfabriken och lyssnaren i sammansättningen.

På sändningssidan används en bindning för att skapa en IChannelFactory, som i sin tur skapar en kanalstack och returnerar en referens till den översta kanalen i stacken. Programmet kan sedan använda den här kanalen för att skicka meddelanden.

På samma sätt används en bindning på mottagarsidan för att skapa en IChannelListener, som lyssnar efter inkommande meddelanden. IChannelListener Tillhandahåller meddelanden till lyssnarprogrammet genom att skapa kanalstackar och ge programmet en referens till den översta kanalen. Programmet använder sedan den här kanalen för att ta emot inkommande meddelanden.