BindingElement 类

定义

public ref class BindingElement abstract

public abstract class BindingElement

type BindingElement = class

Public MustInherit Class BindingElement

继承

Object

BindingElement

派生

System.ServiceModel.Channels.CompositeDuplexBindingElement

System.ServiceModel.Channels.ContextBindingElement

System.ServiceModel.Channels.HttpCookieContainerBindingElement

System.ServiceModel.Channels.MessageEncodingBindingElement

System.ServiceModel.Channels.OneWayBindingElement

更多…

示例

以下示例演示如何将传输绑定元素添加到自定义绑定，然后生成可以接受传入消息的通道侦听器。

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

注解

绑定由一组从此抽象基类继承的有序绑定元素组成。 类 TransportBindingElement 继承自 BindingElement 该类。

如果只是使用通道模型，则为传输创建绑定和绑定元素是可选的。 只要通道工厂公开，就可以通过通道工厂执行所需的一切操作，并倾听者。

Windows Communication Foundation （WCF） 服务模型使用工厂模式，其中绑定用于创建通道堆栈。 如果要使用 WCF 服务模型，则需要使用传输绑定元素。 将此绑定元素放入绑定是一个很好的做法，因为它消除了用户为传输创建自己的自定义绑定的要求。 最好同时创建绑定和绑定元素，并在程序集内隐藏通道工厂和侦听器。

在发送端，绑定用于生成通道 IChannelFactory堆栈，并返回对堆栈中顶部通道的引用。 然后，应用程序可以使用此通道发送消息。

同样，在接收端，绑定用于生成 IChannelListener侦听传入消息的绑定。 通过创建通道堆栈并将应用程序交给顶部通道，向 IChannelListener 侦听应用程序提供消息。 然后，应用程序使用此通道接收传入消息。