DispatcherFrame Klasa

Definicja

Reprezentuje pętlę wykonywania w Dispatcher .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
Dziedziczenie
DispatcherFrame

Przykłady

Poniższy przykład pokazuje, jak używać a, DispatcherFrame Aby osiągnąć podobne wyniki jako metodę Windows Forms DoEvents .The following example shows how to use a DispatcherFrame to achieve similar results as the Windows 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

Uwagi

DispatcherFrame obiekty zwykle należą do dwóch kategorii:DispatcherFrame objects typically fall into two categories:

  • Długotrwałe ramki ogólnego zastosowania, które są zamykane tylko wtedy, gdy jest to pożądane.Long running, general purpose frames that exit only when instructed to. Te ramki powinny zakończyć się w momencie ich żądania.These frames should exit when they are requested.

  • Krótki czas działania, bardzo konkretne ramki, które są zamykane po spełnieniu ważnych kryteriów.Short running, very specific frames that exit when an important criteria is met. Te ramki mogą nie być zamykane, gdy są żądane na rzecz oczekiwania na spełnienie kryteriów zakończenia.These frames may consider not to exit when they are requested in favor of waiting for their exit criteria to be met. Te ramki powinny mieć przypisany limit czasu.These frames should have a time-out associated with them.

Użycie tekstu w języku XAMLXAML Text Usage

Nie można użyć tej klasy zarządzanej w języku XAML.You cannot use this managed class in XAML.

Konstruktory

DispatcherFrame()

Inicjuje nowe wystąpienie klasy DispatcherFrame.Initializes a new instance of the DispatcherFrame class.

DispatcherFrame(Boolean)

Inicjuje nowe wystąpienie DispatcherFrame klasy przy użyciu określonej flagi żądania zakończenia.Initializes a new instance of the DispatcherFrame class, by using the specified exit request flag.

Właściwości

Continue

Pobiera lub ustawia wartość wskazującą, czy ma być DispatcherFrame kontynuowane.Gets or sets a value that indicates whether this DispatcherFrame should continue.

Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)

Metody

CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Dotyczy

Zobacz też