DispatcherObject Class (System.Windows.Threading)

.NET Framework Class Library

DispatcherObject Class

Represents an object that is associated with a Dispatcher.

System..::.Object
System.Windows.Threading..::.DispatcherObject
More...

Namespace: System.Windows.Threading
Assembly: WindowsBase (in WindowsBase.dll)

Public MustInherit Class DispatcherObject

public abstract class DispatcherObject

public ref class DispatcherObject abstract

[<AbstractClass>]
type DispatcherObject =  class end

The DispatcherObject type exposes the following members.

Constructors

	Name	Description
	DispatcherObject	Initializes a new instance of the DispatcherObject class.

Top

Properties

	Name	Description
	Dispatcher	Gets the Dispatcher this DispatcherObject is associated with.

Top

Methods

	Name	Description
	CheckAccess	Determines whether the calling thread has access to this DispatcherObject.
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	VerifyAccess	Enforces that the calling thread has access to this DispatcherObject.

Top

Remarks

Only the thread that the Dispatcher was created on may access the DispatcherObject directly. To access a DispatcherObject from a thread other than the thread the DispatcherObject was created on, call Invoke or BeginInvoke on the Dispatcher the DispatcherObject is associated with.

Subclasses of DispatcherObject that need to enforce thread safety can do so by calling VerifyAccess on all public methods. This guarantees the calling thread is the thread that the DispatcherObject was created on.

A DispatcherObject cannot be independently instantiated; that is, all constructors are protected.

Objects that derive from DispatcherObject have thread affinity.

Objects that derive from Freezable are free-threaded when they are frozen. For more information, see the Freezable Objects Overview.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Thread Safety

Any public static members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

This object can be accessed only from the thread on which it was created. Attempts to access it from other threads will throw an InvalidOperationException. Invoke or BeginInvoke provide support for marshalling work to the correct thread.

Reference

System.Windows.Threading Namespace

Other Resources

Threading Model

Inheritance Hierarchy

Advertise Here