DispatcherObject Class
This page is specific to:.NET Framework Version:
3.03.54
.NET Framework Class Library
DispatcherObject Class

Represents an object that is associated with a Dispatcher.

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

'Usage

Dim instance As DispatcherObject

'Declaration

Public MustInherit Class DispatcherObject
This class is abstract; see Inheritance Hierarchy for derived non-abstract classes usable in XAML.
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.

Inheritance Hierarchy

System..::.Object
  System.Windows.Threading..::.DispatcherObject
    System.Windows.Annotations..::.AnnotationService
    System.Windows..::.Application
    System.Windows.Automation.Peers..::.AutomationPeer
    System.Windows.Data..::.CollectionView
    System.Windows..::.DependencyObject
    System.Windows..::.FrameworkTemplate
    System.Windows.Input..::.InputDevice
    System.Windows.Input..::.InputLanguageManager
    System.Windows.Input..::.InputManager
    System.Windows.Input..::.InputMethod
    System.Windows.Input..::.TextComposition
    System.Windows.Input..::.TextCompositionManager
    System.Windows.Media.Animation..::.Clock
    System.Windows.Media.Animation..::.ClockController
    System.Windows.Media..::.CompositionTarget
    System.Windows.Media..::.DrawingContext
    System.Windows.Media.Imaging..::.BitmapDecoder
    System.Windows.Media.Imaging..::.BitmapEncoder
    System.Windows.Media.Imaging..::.BitmapPalette
    System.Windows.Media..::.StreamGeometryContext
    System.Windows..::.PresentationSource
    System.Windows..::.Style
    System.Windows.Threading..::.DispatcherFrame
    System.Windows..::.WeakEventManager
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.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0
See Also

Reference

Other Resources

© 2010 Microsoft Corporation. All rights reserved.   Terms of Use | Trademarks | Privacy Statement
Page view tracker
Rate the Lightweight library
x
Lightweight builds on ScriptFree (loband) by adding features you've requested: a SearchBox and default code language selection.
Do you like the SearchBox?
Do you like the tabbed code blocks?
How useful is this topic?
Tell us more.
Thanks
x
You're helping to improve MSDN Online.
Feedback
Switch View
Classic
Lightweight Beta
ScriptFree
Switch View