SoapFormatter Constructor (ISurrogateSelector, StreamingContext)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the SoapFormatter class with the specified ISurrogateSelector and StreamingContext.

Namespace:   System.Runtime.Serialization.Formatters.Soap
Assembly:  System.Runtime.Serialization.Formatters.Soap (in System.Runtime.Serialization.Formatters.Soap.dll)

public SoapFormatter(
	ISurrogateSelector selector,
	StreamingContext context
)

Parameters

selector
Type: System.Runtime.Serialization.ISurrogateSelector

The ISurrogateSelector to use with the new instance of SoapFormatter. Can be null.

context
Type: System.Runtime.Serialization.StreamingContext

The StreamingContext that holds the source and destination of the serialization. If the context parameter is null, then the Context defaults to CrossMachine.

Objects are serialized to, or deserialized from, the specified Stream.

The serialization or deserialization process uses the specified ISurrogateSelector to search for surrogates that are registered for the object types you want to deserialize. Surrogates are helpers that serialize and deserialize objects of specific classes. The default ISurrogateSelector cannot handle the serialization of objects that derive from the MarshalByRefObject for remoting purposes. In a remoting situation the specified ISurrogateSelector replaces the object derived from MarshalByRefObject with a ObjRef object that is serialized by the specified surrogate selector. Therefore, if you want to use remote objects, set the selector parameter to an instance of RemotingSurrogateSelector. If you do not need surrogates, set the selector parameter to be null.

.NET Framework
Available since 1.1
Return to top
Show: