BindingElement Klasse

Definition

public ref class BindingElement abstract

public abstract class BindingElement

type BindingElement = class

Public MustInherit Class BindingElement

Vererbung

Object

BindingElement

Abgeleitet

System.ServiceModel.Channels.CompositeDuplexBindingElement

System.ServiceModel.Channels.ContextBindingElement

System.ServiceModel.Channels.HttpCookieContainerBindingElement

System.ServiceModel.Channels.MessageEncodingBindingElement

System.ServiceModel.Channels.OneWayBindingElement

Mehr …

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie ein Transportbindungselement zu einer benutzerdefinierten Bindung hinzufügen und dann einen Kanallistener erstellen, der eingehende Nachrichten akzeptieren kann.

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

Hinweise

Eine Bindung besteht aus einer geordneten Menge Bindungselemente, die von dieser abstrakten Basisklasse erben. Die TransportBindingElement-Klasse erbt von der BindingElement-Klasse.

Das Erstellen einer Bindung und eines Bindungselements für den Transport ist optional, wenn Sie nur das Kanalmodell verwenden. Es ist möglich, alles Nötige über die Kanalfactory und den Listener zu erledigen, solange sie öffentlich gemacht werden.

Das Windows Communication Foundation (WCF)-Dienstmodell verwendet ein Fabrikmuster, in dem die Bindung zum Erstellen des Kanalstapels verwendet wird. Wenn Sie das WCF-Dienstmodell verwenden möchten, ist die Verwendung eines Transportbindungselements erforderlich. Es ist von Vorteil, wenn Sie dieses Bindungselement in eine Bindung einfügen, da Benutzer dann keine eigene benutzerdefinierte Bindung für den Transport erstellen müssen. Sie sollten sowohl eine Bindung als auch ein Bindungselement erstellen und Kanalfactory und -listener in der Assembly verstecken.

Auf der Senderseite wird eine Bindung zum Erstellen einer IChannelFactory verwendet, die wiederum einen Kanalstapel erstellt und einen Verweis auf den obersten Kanal im Stapel zurückgibt. Die Anwendung kann dann diesen Kanal verwenden, um Nachrichten zu senden.

Auf der Empfängerseite wird genauso eine Bindung verwendet, um einen IChannelListener zu erstellen, der eingehende Nachrichten überwacht. Der IChannelListener stellt der überwachenden Anwendung Nachrichten zur Verfügung, indem ein Kanalstapel erstellt und der Anwendungsverweis an den oberen Kanal übergeben wird. Die Anwendung verwendet diesen Kanal dann zum Empfangen eingehender Nachrichten.

Konstruktoren

Methoden

Gilt für