SoapFormatter Constructor (ISurrogateSelector, StreamingContext)
[Visual Basic] Public Sub New( _ ByVal selector As ISurrogateSelector, _ ByVal context As StreamingContext _ ) [C#] public SoapFormatter( ISurrogateSelector selector, StreamingContext context ); [C++] public: SoapFormatter( ISurrogateSelector* selector, StreamingContext context ); [JScript] public function SoapFormatter( selector : ISurrogateSelector, context : StreamingContext );
- The ISurrogateSelector to use with the new instance of SoapFormatter. Can be a null reference (Nothing in Visual Basic).
- The StreamingContext that holds the source and destination of the serialization. If the context parameter is a null reference (Nothing in Visual Basic), 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 an 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 a null reference (Nothing in Visual Basic).
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
.NET Framework Security:
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries From Partially Trusted Code