DispatcherObject Class

Definition

Stellt ein Objekt dar, das einem Dispatcher zugeordnet ist.Represents an object that is associated with a Dispatcher.

public ref class DispatcherObject abstract
public abstract class DispatcherObject
type DispatcherObject = class
Public MustInherit Class DispatcherObject
Inheritance
DispatcherObject
Derived

Remarks

Nur der Thread, auf dem der Dispatcher erstellt wurde, kann direkt auf die DispatcherObject zugreifen.Only the thread that the Dispatcher was created on may access the DispatcherObject directly. Um auf eine DispatcherObject von einem anderen Thread als dem Thread zuzugreifen, auf dem die DispatcherObject erstellt wurde, wenden Sie Invoke oder BeginInvoke für den Dispatcher an, dem die DispatcherObject zugeordnet ist.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.

Unterklassen von DispatcherObject, die Thread Sicherheit erzwingen müssen, können dies erreichen, indem Sie VerifyAccess für alle öffentlichen Methoden aufrufen.Subclasses of DispatcherObject that need to enforce thread safety can do so by calling VerifyAccess on all public methods. Dadurch wird sichergestellt, dass der aufrufenden Thread der Thread ist, in dem der DispatcherObject erstellt wurde.This guarantees the calling thread is the thread that the DispatcherObject was created on.

Eine DispatcherObject kann nicht unabhängig instanziiert werden. Das heißt, alle Konstruktoren sind geschützt.A DispatcherObject cannot be independently instantiated; that is, all constructors are protected.

Objekte, die von DispatcherObject abgeleitet sind, haben Thread Affinität.Objects that derive from DispatcherObject have thread affinity.

Objekte, die von Freezable abgeleitet sind, sind frei Thread frei, wenn Sie eingefroren sind.Objects that derive from Freezable are free-threaded when they are frozen. Weitere Informationen finden Sie unter der Übersicht über Freezable-Objekte.For more information, see the Freezable Objects Overview.

Constructors

DispatcherObject()

Initialisiert eine neue Instanz der Klasse DispatcherObject.Initializes a new instance of the DispatcherObject class.

Properties

Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

Methods

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

Applies to

Thread Safety

Alle öffentlichen static-Member dieses Typs sind threadsicher.Any public static members of this type are thread safe. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.Any instance members are not guaranteed to be thread safe.

Auf dieses Objekt kann nur über den Thread zugegriffen werden, in dem es erstellt wurde.This object can be accessed only from the thread on which it was created. Zugriffsversuche aus anderen Threads lösen eine InvalidOperationExceptionaus.Attempts to access it from other threads will throw an InvalidOperationException. Invoke(DispatcherPriority, Delegate) oder BeginInvoke(DispatcherPriority, Delegate) unterstützen das Marshalling von Arbeit mit dem richtigen Thread.Invoke(DispatcherPriority, Delegate) or BeginInvoke(DispatcherPriority, Delegate) provide support for marshaling work to the correct thread.