StreamingContext Structure

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Describes the source and destination of a given serialized stream, and provides an additional caller-defined context.

Namespace:  System.Runtime.Serialization
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public Structure StreamingContext
[ComVisibleAttribute(true)]
public struct StreamingContext

The StreamingContext type exposes the following members.

Constructors

  Name Description
Public method StreamingContext(StreamingContextStates) Initializes a new instance of the StreamingContext class with a given context state.
Public method StreamingContext(StreamingContextStates, Object) Initializes a new instance of the StreamingContext class with a given context state, and some additional information.

Top

Properties

  Name Description
Public property Context Gets the context specified as part of the additional context.
Public property State Gets the source or destination of the transmitted data.

Top

Methods

  Name Description
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Equals Determines whether two StreamingContext instances contain the same values. (Overrides ValueType.Equals(Object).)
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Finalize Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetHashCode Returns a hash code of this object. (Overrides ValueType.GetHashCode().)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetType Gets the Type of the current instance. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ToString Returns the fully qualified type name of this instance. (Inherited from ValueType.)

Top

Remarks

Indicates the source or destination of the bits that the formatter uses. Classes with surrogates or that implement ISerializable can serialize or ignore fields and values based on the information stored in the streaming context. For example, a window handle is still valid if the State property is set to CrossProcess.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.