System.Runtime.Remoting.Channels.BinaryServerFormatterSinkProvider Class

Assembly: System.Runtime.Remoting.dll
Namespace: System.Runtime.Remoting.Channels
Summary
Provides the implementation for the server formatter channel sink provider that uses the BinaryFormatter.
C# Syntax:
public class BinaryServerFormatterSinkProvider : IServerFormatterSinkProvider, IServerChannelSinkProvider
Remarks
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 IServerChannelSinkProvider.Next for this purpose.

When multiple channel sink providers are provided 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 will be created when the channel is 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 provider.



Property Description
includeVersions true or false . Specifies whether the formatter will include versioning information.
See also:
System.Runtime.Remoting.Channels Namespace | BinaryServerFormatterSink | MSDN: channelformatterconfigurationproperties

System.Runtime.Remoting.Channels.BinaryServerFormatterSinkProvider Member List:

Public Constructors
ctor #1 Overloaded:
.ctor()

Default constructor. This constructor is called by derived class constructors to initialize state in this type.
Initializes a new instance of the BinaryServerFormatterSinkProvider class with default values.
ctor #2 Overloaded:
.ctor(IDictionary properties, ICollection providerData)

Initializes a new instance of the BinaryServerFormatterSinkProvider class with the provided properties and provider data.
Public Properties
Next Read-write

Gets or sets the next IServerChannelSinkProvider in the sink provider chain.
Public Methods
CreateSink Creates a sink chain.
Equals
(inherited from System.Object)
See base class member description: System.Object.Equals

Derived from System.Object, the primary base class for all objects.
GetChannelData Returns the channel data for the channel that the current sink is associated with.
GetHashCode
(inherited from System.Object)
See base class member description: System.Object.GetHashCode

Derived from System.Object, the primary base class for all objects.
GetType
(inherited from System.Object)
See base class member description: System.Object.GetType

Derived from System.Object, the primary base class for all objects.
ToString
(inherited from System.Object)
See base class member description: System.Object.ToString

Derived from System.Object, the primary base class for all objects.
Protected Methods
Finalize
(inherited from System.Object)
See base class member description: System.Object.Finalize

Derived from System.Object, the primary base class for all objects.
MemberwiseClone
(inherited from System.Object)
See base class member description: System.Object.MemberwiseClone

Derived from System.Object, the primary base class for all objects.

Hierarchy:


System.Runtime.Remoting.Channels.BinaryServerFormatterSinkProvider Member Details

Overloaded ctor #1
Summary
Initializes a new instance of the BinaryServerFormatterSinkProvider class with default values.

Default constructor. This constructor is called by derived class constructors to initialize state in this type.
C# Syntax:
public BinaryServerFormatterSinkProvider();

Return to top


Overloaded ctor #2
Summary
Initializes a new instance of the BinaryServerFormatterSinkProvider class with the provided properties and provider data.
C# Syntax:
public BinaryServerFormatterSinkProvider(
   IDictionary properties,
   ICollection providerData
);
Parameters:

properties

An IDictionary of configuration properties to use with the new instance of BinaryServerFormatterSinkProvider.

providerData

An ICollection of SinkProviderData to use with the new instance of BinaryServerFormatterSinkProvider.

Return to top


Property: Next (read-write)
Summary
Gets or sets the next IServerChannelSinkProvider in the sink provider chain.
C# Syntax:
public IServerChannelSinkProvider Next {get; set;}
Implements:
IServerChannelSinkProvider.Next

Return to top


Method: CreateSink(
   IChannelReceiver channel
)
Summary
Creates a sink chain.
C# Syntax:
public IServerChannelSink CreateSink(
   IChannelReceiver channel
);
Parameters:

channel

The channel for which to create the channel sink chain.

Return Value:
The first sink of the newly formed channel sink chain.
Implements:
IServerChannelSinkProvider.CreateSink

Return to top


Method: Equals(
   object obj
)
Inherited
See base class member description: System.Object.Equals
C# Syntax:
public virtual bool Equals(
   object obj
);

For more information on members inherited from System.Object click on the link above.

Return to top


Method: Finalize()
Inherited
See base class member description: System.Object.Finalize
C# Syntax:
~BinaryServerFormatterSinkProvider();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: GetChannelData(
   IChannelDataStore channelData
)
Summary
Returns the channel data for the channel that the current sink is associated with.
C# Syntax:
public void GetChannelData(
   IChannelDataStore channelData
);
Parameters:

channelData

An IChannelDataStore object in which the channel data is to be returned.

Implements:
IServerChannelSinkProvider.GetChannelData

Return to top


Method: GetHashCode()
Inherited
See base class member description: System.Object.GetHashCode
C# Syntax:
public virtual int GetHashCode();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: GetType()
Inherited
See base class member description: System.Object.GetType
C# Syntax:
public Type GetType();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: MemberwiseClone()
Inherited
See base class member description: System.Object.MemberwiseClone
C# Syntax:
protected object MemberwiseClone();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: ToString()
Inherited
See base class member description: System.Object.ToString
C# Syntax:
public virtual string ToString();

For more information on members inherited from System.Object click on the link above.

Return to top


Top of page

Copyright (c) 2002 Microsoft Corporation. All rights reserved.