This documentation is archived and is not being maintained.

SoapServerFormatterSinkProvider Class

Provides the implementation for a server formatter channel sink provider that uses the SoapFormatter.

For a list of all members of this type, see SoapServerFormatterSinkProvider Members.


[Visual Basic]
Public Class SoapServerFormatterSinkProvider
   Implements IServerFormatterSinkProvider, _
public class SoapServerFormatterSinkProvider :
   IServerFormatterSinkProvider, IServerChannelSinkProvider
public __gc class SoapServerFormatterSinkProvider : public
   IServerFormatterSinkProvider, IServerChannelSinkProvider
public class SoapServerFormatterSinkProvider implements
   IServerFormatterSinkProvider, IServerChannelSinkProvider

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


Channel sinks are connected to a server channel through implementations of the IServerChannelSinkProvider interface. All the remoting server channels provide constructors that take an IServerChannelSinkProvider 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. IServerChannelSinkProvider provides a property called 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 and the channels are created during the RemotingConfiguration.Configure call.

Formatter sinks use sink configuration properties to configure the channel at run time. Sink properties can be specified in a configuration file, or programmatically, inside of an IDictionary. In a configuration file all values are represented by strings, but when building a property IDictionary programmatically, value types can be specified with their native values or with strings.

The following table shows the sink configuration properties that can be specified for the current sink.

Property Description
includeVersions true or false. Specifies whether the formatter will include versioning information.


Namespace: System.Runtime.Remoting.Channels

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Runtime.Remoting (in System.Runtime.Remoting.dll)

See Also

SoapServerFormatterSinkProvider Members | System.Runtime.Remoting.Channels Namespace | Channel and Formatter Configuration Properties | Sinks and Sink Chains