DispatcherObject Class

.NET Framework (current version)

Represents an object that is associated with a Dispatcher.

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

Inheritance Hierarchy

Syntax

C++

[<AbstractClass>]
type DispatcherObject = class end

Constructors

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

Properties

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

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 the default hash function. (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.

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
Available since 3.0

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.