BinaryClientFormatterSinkProvider Class

Reference

Definition

Namespace:: System.Runtime.Remoting.Channels

Assembly:: System.Runtime.Remoting.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides the implementation for the binary client formatter sink provider.

public ref class BinaryClientFormatterSinkProvider : System::Runtime::Remoting::Channels::IClientFormatterSinkProvider

public class BinaryClientFormatterSinkProvider : System.Runtime.Remoting.Channels.IClientFormatterSinkProvider

type BinaryClientFormatterSinkProvider = class
    interface IClientFormatterSinkProvider
    interface IClientChannelSinkProvider

Public Class BinaryClientFormatterSinkProvider
Implements IClientFormatterSinkProvider

Inheritance: Object
BinaryClientFormatterSinkProvider

Implements: IClientChannelSinkProvider IClientFormatterSinkProvider

Remarks

A BinaryClientFormatterSinkProvider creates client formatter sinks that use the BinaryFormatter 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 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. You can do this by implementing both the IMessageSink and IClientChannelSink interfaces. The formatter sink can then 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`.

Important

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 Validate All Inputs.

Constructors

BinaryClientFormatterSinkProvider()	Initializes a new instance of the BinaryClientFormatterSinkProvider class with default values.
BinaryClientFormatterSinkProvider(IDictionary, ICollection)	Initializes a new instance of the BinaryClientFormatterSinkProvider class with the given properties and provider data.

Properties

Next	Gets or sets the next IClientChannelSinkProvider in the sink provider chain.

Methods

CreateSink(IChannelSender, String, Object)	Creates a sink chain.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Applies to

Share via