DispatcherFrame DispatcherFrame DispatcherFrame DispatcherFrame Class

Definition

Stellt eine Ausführungsschleife im Dispatcher dar.Represents an execution loop in the Dispatcher.

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
DispatcherFrameDispatcherFrameDispatcherFrameDispatcherFrame

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein DispatcherFrame verwendet wird, um ähnliche Ergebnisse Windows FormsWindows Forms wie die DoEvents -Methode zu erzielen.The following example shows how to use a DispatcherFrame to achieve similar results as the Windows FormsWindows Forms DoEvents method.

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
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

DispatcherFrameObjekte werden in der Regel in zwei Kategorien unterteilt:DispatcherFrame objects typically fall into two categories:

  • Lange laufende, allgemeine Frames, die nur beendet werden, wenn an die Anweisung übergeben wird.Long running, general purpose frames that exit only when instructed to. Diese Frames sollten beendet werden, wenn Sie angefordert werden.These frames should exit when they are requested.

  • Kurze laufende, sehr spezifische Frames, die beendet werden, wenn ein wichtiges Kriterium erfüllt ist.Short running, very specific frames that exit when an important criteria is met. Diese Frames werden möglicherweise nicht beendet, wenn Sie angefordert werden, um zu warten, bis Ihre Beendigungs Kriterien erfüllt werden.These frames may consider not to exit when they are requested in favor of waiting for their exit criteria to be met. Diesen Frames sollte ein Timeout zugeordnet sein.These frames should have a time-out associated with them.

Verwendung von XAML-TextXAML Text Usage

Diese verwaltete Klasse kann nicht in XAMLXAMLverwendet werden.You cannot use this managed class in XAMLXAML.

Konstruktoren

DispatcherFrame() DispatcherFrame() DispatcherFrame() DispatcherFrame()

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

DispatcherFrame(Boolean) DispatcherFrame(Boolean) DispatcherFrame(Boolean) DispatcherFrame(Boolean)

Initialisiert eine neue Instanz der DispatcherFrame-Klasse mit dem angegebenen Flag für eine Beendigungsanforderung.Initializes a new instance of the DispatcherFrame class, by using the specified exit request flag.

Eigenschaften

Continue Continue Continue Continue

Ruft einen Wert ab, mit dem angegeben wird, ob dieser DispatcherFrame fortgesetzt werden soll, oder legt diesen Wert fest.Gets or sets a value that indicates whether this DispatcherFrame should continue.

Dispatcher Dispatcher Dispatcher Dispatcher

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

(Inherited from DispatcherObject)

Methoden

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

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

(Inherited from DispatcherObject)
Equals(Object) Equals(Object) Equals(Object) 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() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

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

(Inherited from DispatcherObject)

Gilt für:

Siehe auch