This documentation is archived and is not being maintained.

SoapFormatter Constructor (ISurrogateSelector, StreamingContext)

.NET Framework 1.1

Initializes a new instance of the SoapFormatter class with the specified ISurrogateSelector and 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
);

Parameters

selector
The ISurrogateSelector to use with the new instance of SoapFormatter. Can be a null reference (Nothing in Visual Basic).
context
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.

Remarks

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).

Requirements

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: 

See Also

SoapFormatter Class | SoapFormatter Members | System.Runtime.Serialization.Formatters.Soap Namespace | SoapFormatter Constructor Overload List | StreamingContext

Show: