Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

IChannelListener<TChannel> Interface

.NET Framework 4

Defines the interface that must be implemented by channel listeners to accept type-specific channels.

Namespace:  System.ServiceModel.Channels
Assembly:  System.ServiceModel (in System.ServiceModel.dll)
C#
C++
F#
VB
Copy 
public interface IChannelListener<TChannel> : IChannelListener, 
	ICommunicationObject
where TChannel : class, IChannel

Type Parameters

TChannel

The type of channel that the channel listener accepts.

The IChannelListener<TChannel> type exposes the following members.

  Name Description
Public property State Gets the current state of the communication-oriented object. (Inherited from ICommunicationObject.)
Public property Uri Gets the URI on which the listeners that are generated by the factory listen. (Inherited from IChannelListener.)
Top
  Name Description
Public method Abort Causes a communication object to transition immediately from its current state into the closed state. (Inherited from ICommunicationObject.)
Public method AcceptChannel() Accepts a channel of a specified type for communication with a client.
Public method AcceptChannel(TimeSpan) Accepts a channel of a specified type for communication with a client within a specified interval of time.
Public method BeginAcceptChannel(AsyncCallback, Object) Begins an asynchronous operation to accept a channel.
Public method BeginAcceptChannel(TimeSpan, AsyncCallback, Object) Begins an asynchronous operation to accept a channel within a specified interval of time.
Public method BeginClose(AsyncCallback, Object) Begins an asynchronous operation to close a communication object. (Inherited from ICommunicationObject.)
Public method BeginClose(TimeSpan, AsyncCallback, Object) Begins an asynchronous operation to close a communication object with a specified timeout. (Inherited from ICommunicationObject.)
Public method BeginOpen(AsyncCallback, Object) Begins an asynchronous operation to open a communication object. (Inherited from ICommunicationObject.)
Public method BeginOpen(TimeSpan, AsyncCallback, Object) Begins an asynchronous operation to open a communication object within a specified interval of time. (Inherited from ICommunicationObject.)
Public method BeginWaitForChannel Begins an asynchronous operation to wait for a channel to arrive that must be completed within a specified interval of time. (Inherited from IChannelListener.)
Public method Close() Causes a communication object to transition from its current state into the closed state. (Inherited from ICommunicationObject.)
Public method Close(TimeSpan) Causes a communication object to transition from its current state into the closed state. (Inherited from ICommunicationObject.)
Public method EndAcceptChannel Completes an asynchronous operation to accept a channel.
Public method EndClose Completes an asynchronous operation to close a communication object. (Inherited from ICommunicationObject.)
Public method EndOpen Completes an asynchronous operation to open a communication object. (Inherited from ICommunicationObject.)
Public method EndWaitForChannel Completes an asynchronous operation to wait for channels to arrive. (Inherited from IChannelListener.)
Public method GetProperty<T> Returns a typed object requested, if present, from the appropriate layer in the channel stack. (Inherited from IChannelListener.)
Public method Open() Causes a communication object to transition from the created state into the opened state. (Inherited from ICommunicationObject.)
Public method Open(TimeSpan) Causes a communication object to transition from the created state into the opened state within a specified interval of time. (Inherited from ICommunicationObject.)
Public method WaitForChannel Waits for a channel to arrive. (Inherited from IChannelListener.)
Top
  Name Description
Public event Closed Occurs when the communication object completes its transition from the closing state into the closed state. (Inherited from ICommunicationObject.)
Public event Closing Occurs when the communication object first enters the closing state. (Inherited from ICommunicationObject.)
Public event Faulted Occurs when the communication object first enters the faulted state. (Inherited from ICommunicationObject.)
Public event Opened Occurs when the communication object completes its transition from the opening state into the opened state. (Inherited from ICommunicationObject.)
Public event Opening Occurs when the communication object first enters the opening state. (Inherited from ICommunicationObject.)
Top

Listener factories that implement the IChannelListener or IChannelListener<TChannel> interfaces provide services with the mechanisms used to accept the channels produced by clients that initiate and enable communication with a service.

Implementing the IChannelListener<TChannel> contract allows users to accept multiple channels of a given type without having to specify the channel type each time. In other words, defining the channel type as a generic parameter for the IChannelListener<TChannel> interface means that it is not necessary to pass the type into the AcceptChannel methods. If users want to accept different channel types, they can create additional channel listeners for each type of channel required.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ