OneWayBindingElement.PacketRoutable Property

Definition

Gets or sets a value that indicates whether packet routing is enabled.

public:
 property bool PacketRoutable { bool get(); void set(bool value); };
public bool PacketRoutable { get; set; }
member this.PacketRoutable : bool with get, set
Public Property PacketRoutable As Boolean

Property Value

true if packet routing is enabled; otherwise, false. The default is false.

Remarks

This class can optionally use a message-level protocol that transforms a DuplexSessionChannel/RequestChannel/ReplyChannel to a one-way channel and allows the messages from the transformed channel to be routed. Usage of this protocol is controlled by the PacketRoutable property.

When this property is true, upon DuplexSessionChannel initiation (for example, Buffered TCP and Named Pipes), this class adds a message header (MustUnderstand = false, signed if security is enabled) that semantically means "you can packet-route this channel". On the acceptor side, when this property is true, this class looks for this header in the first message received on the channel. If this header does not exist, WCF faults the channel. If the header exists, then WCF funnels the new channel into a shared input channel.

To transform a Request-Reply channel (for example, TCP Streaming or HTTP) when this property is true, this header is added to every request to signal that the request can be packet routed. WCF also verifies that SendRequest returns null and replies with null on the server.

Applies to