MsmqTransportBindingElement.BuildChannelListener<TChannel> Method

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Builds a channel listener using the context provided.

public:
generic <typename TChannel>
 where TChannel : class, System::ServiceModel::Channels::IChannel override System::ServiceModel::Channels::IChannelListener<TChannel> ^ BuildChannelListener(System::ServiceModel::Channels::BindingContext ^ context);

public override System.ServiceModel.Channels.IChannelListener<TChannel> BuildChannelListener<TChannel> (System.ServiceModel.Channels.BindingContext context) where TChannel : class, System.ServiceModel.Channels.IChannel;

override this.BuildChannelListener : System.ServiceModel.Channels.BindingContext -> System.ServiceModel.Channels.IChannelListener<'Channel (requires 'Channel : null and 'Channel :> System.ServiceModel.Channels.IChannel)> (requires 'Channel : null and 'Channel :> System.ServiceModel.Channels.IChannel)

Public Overrides Function BuildChannelListener(Of TChannel As {Class, IChannel}) (context As BindingContext) As IChannelListener(Of TChannel)

Type Parameters

TChannel

The channel type to be used to build the channel listener. Permitted channel types are IInputSessionChannel or a IInputChannel class.

Parameters

context

BindingContext

The BindingContext with which to build the channel listener.

Returns

IChannelListener<TChannel>

A Message Queuing (MSMQ) channel listener that can be used to create channels to receive messages from existing MSMQ applications.

Exceptions

ArgumentNullException

The context value is null.

ArgumentException

The TChannel is not IInputChannel or IInputSessionChannel.

InvalidOperationException

ExactlyOnce is true and Durable is false.

-or-

Queue not readable.

-or-

ExactlyOnce is true and queue is non-transactional.

-or-

ExactlyOnce is false and queue is transactional.

-or-

ReceiveErrorHandling is set to Move and queue name contains a ";" in Windows Vista.

-or-

ExactlyOnce is set to true and cannot open retry sub-queue in Windows Vista.

-or-

ReceiveErrorHandling is set to Reject or Move and the platform is Windows Vista.

-or-

MsmqTransportSecurity.MsmqAuthenticationMode is set to WindowsDomain and MSMQ is installed without ActiveDirectory integration.

-or-

MsmqTransportSecurity.MsmqAuthenticationMode is None and MsmqTransportSecurity.MsmqProtectionLevel is not None.

-or-

MsmqTransportSecurity.MsmqAuthenticationMode is Certificate or WindowsDomain and MsmqTransportSecurity.MsmqProtectionLevel is None.

Examples

transportBindingElement.BuildChannelListener<IInputChannel>(context);