Export (0) Print
Expand All

SoapClientFormatterSinkProvider Class

Provides the implementation for a client formatter sink provider.

Namespace: System.Runtime.Remoting.Channels
Assembly: System.Runtime.Remoting (in system.runtime.remoting.dll)

public class SoapClientFormatterSinkProvider : IClientFormatterSinkProvider, IClientChannelSinkProvider
public class SoapClientFormatterSinkProvider implements IClientFormatterSinkProvider, IClientChannelSinkProvider
public class SoapClientFormatterSinkProvider implements IClientFormatterSinkProvider, IClientChannelSinkProvider
Not applicable.

A SoapClientFormatterSinkProvider creates client formatter sinks that use the SoapFormatter to serialize messages for the client channel through which remoting messages flow.

The function of the formatter sink is to generate the necessary headers and serialize the message to the stream. After reaching the formatter sink, the IMessage is forwarded to all sinks in the channel sink chain through the ProcessMessage or AsyncProcessRequest calls. At this stage the message has already been serialized and is provided as information only. Sinks that need to create or modify the message must be placed in the sink chain before the formatter. This can be achieved by implementing both the IMessageSink and IClientChannelSink interfaces. The formatter sink can be placed in the sink chain later.

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 provider.

Property

Description

includeVersions

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

System.Object
  System.Runtime.Remoting.Channels.SoapClientFormatterSinkProvider

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

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft