SoapFormatter Constructor (ISurrogateSelector, StreamingContext)

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)

'Declaration
Public Sub New ( _
	selector As ISurrogateSelector, _
	context As StreamingContext _
)

Parameters

selector
Type: System.Runtime.Serialization.ISurrogateSelector

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

context
Type: System.Runtime.Serialization.StreamingContext

The StreamingContext that holds the source and destination of the serialization. If the context parameter is Nothing, 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 Nothing.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft