System.Runtime.Remoting.Channels.IClientChannelSinkProvider Interface

Summary

Creates client channel sinks for the client channel through which remoting messages flow.

C# Syntax:

public interface IClientChannelSinkProvider

Channel sinks are connected to a client channel through implementations of the IClientChannelSinkProvider interface. All the remoting client channels provide constructors that take an IClientChannelSinkProvider as a parameter.

Channel sink providers are stored in a chain, and the user is responsible for chaining all channel sink providers together before passing the outer one to the channel constructor. IClientChannelSinkProvider provides a property called IServerChannelSinkProvider.Next for this purpose.

When multiple channel sink providers are specified in a configuration file, the remoting infrastructure will chain them together in the order they are found in the configuration file. The channel sink providers will be created when the channel is created during the RemotingConfiguration.Configure call.

System.Runtime.Remoting.Channels Namespace

System.Runtime.Remoting.Channels.IClientChannelSinkProvider Member List:

Public Properties

Next	Read-write Gets or sets the next sink provider in the channel sink provider chain.

Public Methods

CreateSink

Creates a sink chain.

System.Runtime.Remoting.Channels.IClientChannelSinkProvider Member Details

Summary

Gets or sets the next sink provider in the channel sink provider chain.

C# Syntax:

IClientChannelSinkProvider Next {get; set;}

Return to top

Summary

Creates a sink chain.

C# Syntax:

IClientChannelSink CreateSink(    IChannelSender channel,    string url,    object remoteChannelData );

channel

Channel for which the current sink chain is being constructed.

url

The URL of the object to connect to. This parameter can be null if the connection is based entirely on the information contained in the remoteChannelData parameter.

remoteChannelData

A channel data object describing a channel on the remote server. A channel data object describing a channel on the remote server.

Return Value:

The first sink of the newly formed channel sink chain, or null indicating that this provider will not or cannot provide a connection for this endpoint.

When the IClientChannelSinkProvider.CreateSink method is called, it creates its own channel sink, forwards the IClientChannelSinkProvider.CreateSink call to the next sink provider in the chain (if there is one), and ensures that the next sink and the current one are linked together.

Return to top

Top of page