DispatcherTimer Klasse

Definition

public ref class DispatcherTimer

public class DispatcherTimer

type DispatcherTimer = class

Public Class DispatcherTimer

Vererbung

Object

DispatcherTimer

Beispiele

Im folgenden Beispiel wird ein DispatcherTimer Objekt erstellt, das den Inhalt eines Elements Label aktualisiert und die InvalidateRequerySuggested Methode für die CommandManager.

Ein benanntes DispatcherTimerdispatcherTimer Objekt wird erstellt. Der Ereignishandler dispatcherTimer_Tick wird dem Tick Ereignis von dispatcherTimerhinzugefügt. Die Interval Einstellung wird mithilfe eines TimeSpan Objekts auf 1 Sekunde festgelegt, und der Timer wird gestartet.

//  DispatcherTimer setup
dispatcherTimer = new System.Windows.Threading.DispatcherTimer();
dispatcherTimer.Tick += new EventHandler(dispatcherTimer_Tick);
dispatcherTimer.Interval = TimeSpan.FromSeconds(1);
dispatcherTimer.Start();

'  DispatcherTimer setup
dispatcherTimer = New Threading.DispatcherTimer()
AddHandler dispatcherTimer.Tick, AddressOf dispatcherTimer_Tick
dispatcherTimer.Interval = New TimeSpan(0,0,1)
dispatcherTimer.Start()

Der Tick Ereignishandler aktualisiert ein Label Ereignis, das die aktuelle Sekunde anzeigt, und ruft InvalidateRequerySuggested dies auf.CommandManager

//  System.Windows.Threading.DispatcherTimer.Tick handler
//
//  Updates the current seconds display and calls
//  InvalidateRequerySuggested on the CommandManager to force 
//  the Command to raise the CanExecuteChanged event.
private void dispatcherTimer_Tick(object sender, EventArgs e)
{
    // Updating the Label which displays the current second
    lblSeconds.Content = DateTime.Now.Second;

    // Forcing the CommandManager to raise the RequerySuggested event
    CommandManager.InvalidateRequerySuggested();
}

'  System.Windows.Threading.DispatcherTimer.Tick handler
'
'  Updates the current seconds display and calls
'  InvalidateRequerySuggested on the CommandManager to force 
'  the Command to raise the CanExecuteChanged event.
Private Sub dispatcherTimer_Tick(ByVal sender As Object, ByVal e As EventArgs)
    ' Updating the Label which displays the current second
    lblSeconds.Content = Date.Now.Second

    ' Forcing the CommandManager to raise the RequerySuggested event
    CommandManager.InvalidateRequerySuggested()
End Sub

Hinweise

Die DispatcherTimer Neubewertung erfolgt oben in jeder Dispatcher Schleife.

Timer werden nicht garantiert genau ausgeführt, wenn das Zeitintervall auftritt, aber sie werden garantiert nicht ausgeführt, bevor das Zeitintervall auftritt. Dies liegt daran, dass DispatcherTimer Vorgänge wie andere Vorgänge in der Dispatcher Warteschlange platziert werden. Wenn der DispatcherTimer Vorgang ausgeführt wird, hängt von den anderen Aufträgen in der Warteschlange und deren Prioritäten ab.

Wenn ein System.Timers.Timer in einer WPF-Anwendung verwendet wird, ist es erwähnenswert, dass die System.Timers.Timer auf einem anderen Thread als dem Ui-Thread (Ui) ausgeführt wird. Um auf Objekte im UI-Thread (User Interface) zuzugreifen, ist es erforderlich, den Vorgang mithilfe oder auf den Dispatcher Ui-Thread des Ui-Threads InvokeBeginInvoke(User Interface) zu veröffentlichen. Gründe für die Verwendung im DispatcherTimer Gegensatz zu einem System.Timers.Timer sind, dass die DispatcherTimer Ausführung auf demselben Thread wie die Dispatcher und eine DispatcherPriority für die DispatcherTimer.

Ein DispatcherTimer Objekt bleibt erhalten, wenn die Methoden des Objekts an den Timer gebunden sind.