This documentation is archived and is not being maintained.

TcpChannel Constructor (IDictionary, IClientChannelSinkProvider, IServerChannelSinkProvider)

Initializes a new instance of the TcpChannel class with the specified configuration properties and sinks.

Namespace:  System.Runtime.Remoting.Channels.Tcp
Assembly:  System.Runtime.Remoting (in System.Runtime.Remoting.dll)

public TcpChannel(
	IDictionary properties,
	IClientChannelSinkProvider clientSinkProvider,
	IServerChannelSinkProvider serverSinkProvider


Type: System.Collections.IDictionary
A IDictionary collection that specifies values for configuration properties to be used by the client and server channels.
Type: System.Runtime.Remoting.Channels.IClientChannelSinkProvider
The IClientChannelSinkProvider implementation to be used by the client channel.
Type: System.Runtime.Remoting.Channels.IServerChannelSinkProvider
The IServerChannelSinkProvider implementation to be used by the server channel.


A provided channel property was improperly formatted.

For more information about channel configuration properties, see Channel and Formatter Configuration Properties.


If the server computer is running Windows 95/98/Me, the server TcpChannel cannot be specified as secure.

Channel sinks provide a plug-in point that allows access to the underlying messages flowing through the channel as well as the stream used by the transport mechanism to send messages to a remote object. Channel sinks are also responsible for transporting messages between the client and the server. Channel sinks are linked together in a chain, and all channel messages flow through this chain of sinks before the message is finally serialized and transported. If you do not require sink functionality, set the clientSinkProvider and serverSinkProvider parameters to null.

The following code example shows how to use this constructor.

// Specify the properties for the server channel.
System.Collections.IDictionary dict = 
    new System.Collections.Hashtable();
dict["port"] = 9090;
dict["authenticationMode"] = "IdentifyCallers";

// Set up the server channel.
TcpChannel serverChannel = new TcpChannel(dict, null, null);

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, 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.