DispatcherFrame Klasse

Definition

Namespace:

System.Windows.Threading

Assembly:

WindowsBase.dll

Stellt eine Ausführungsschleife im Dispatcher dar.

public ref class DispatcherFrame : System::Windows::Threading::DispatcherObject

public class DispatcherFrame : System.Windows.Threading.DispatcherObject

type DispatcherFrame = class
    inherit DispatcherObject

Public Class DispatcherFrame
Inherits DispatcherObject

Vererbung

Object

DispatcherObject

DispatcherFrame

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie ähnliche DispatcherFrame Ergebnisse wie die Windows Forms-Methode DoEvents verwenden.

public void DoEvents()
{
    DispatcherFrame frame = new DispatcherFrame();
    Dispatcher.CurrentDispatcher.BeginInvoke(DispatcherPriority.Background,
        new DispatcherOperationCallback(ExitFrame), frame);
    Dispatcher.PushFrame(frame);
}

public object ExitFrame(object f)
{
    ((DispatcherFrame)f).Continue = false;
   
    return null;
}

<SecurityPermissionAttribute(SecurityAction.Demand, Flags := SecurityPermissionFlag.UnmanagedCode)>
Public Sub DoEvents()
    Dim frame As New DispatcherFrame()
    Dispatcher.CurrentDispatcher.BeginInvoke(DispatcherPriority.Background, New DispatcherOperationCallback(AddressOf ExitFrame), frame)
    Dispatcher.PushFrame(frame)
End Sub

Public Function ExitFrame(ByVal f As Object) As Object
    CType(f, DispatcherFrame).Continue = False

    Return Nothing
End Function

Hinweise

DispatcherFrame Objekte fallen in der Regel in zwei Kategorien:

• Lang ausgeführte, allgemeine Frames, die nur beendet werden, wenn sie angewiesen werden. Diese Frames sollten beendet werden, wenn sie angefordert werden.

• Kurze Ausführung, sehr spezifische Frames, die beendet werden, wenn eine wichtige Kriterien erfüllt ist. Diese Frames sollten möglicherweise nicht beenden, wenn sie angefordert werden, um zu warten, dass ihre Ausgangskriterien erfüllt werden. Diese Frames sollten über ein Timeout verfügen, das ihnen zugeordnet ist.

XAML-Textverwendung

Sie können diese verwaltete Klasse in XAML nicht verwenden.

Konstruktoren

DispatcherFrame()	Initialisiert eine neue Instanz der DispatcherFrame-Klasse.
DispatcherFrame(Boolean)	Initialisiert eine neue Instanz der DispatcherFrame-Klasse mit dem angegebenen Flag für eine Beendigungsanforderung.

Eigenschaften

Continue	Ruft einen Wert ab, mit dem angegeben wird, ob dieser DispatcherFrame fortgesetzt werden soll, oder legt diesen Wert fest.
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)

Methoden

CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)

Siehe auch

• PushFrame(DispatcherFrame)