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 сообщения приложению для прослушивания, создавая стеки каналов и передавая приложению ссылку на верхний канал. Затем приложение использует этот канал для получения входящих сообщений.