System.Runtime.Remoting.Channels.SoapServerFormatterSinkProvider Class

Provides the implementation for a server formatter channel sink provider that uses the System.Runtime.Serialization.Formatters.Soap.SoapFormatter.

See Also: SoapServerFormatterSinkProvider Members


public class SoapServerFormatterSinkProvider : IServerFormatterSinkProvider


Channel sinks are connected to a server channel through implementations of the System.Runtime.Remoting.Channels.IServerChannelSinkProvider interface. All the remoting server channels provide constructors that take a System.Runtime.Remoting.Channels.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. System.Runtime.Remoting.Channels.IServerChannelSinkProvider 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 and the channels are created during the System.Runtime.Remoting.RemotingConfiguration.Configure(string) 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 a 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.


Specifies whether the formatter will include versioning information. Values are true or false.


Using an instance of this object with untrusted data or across an unsecure channel is a security risk. Use this object only with trusted data and across a secure channel. For more information, see tp://


Namespace: System.Runtime.Remoting.Channels
Assembly: System.Runtime.Remoting (in System.Runtime.Remoting.dll)
Assembly Versions: 1.0.3300.0, 1.0.5000.0,