DispatcherTimer Classe

Definição

public ref class DispatcherTimer

public class DispatcherTimer

type DispatcherTimer = class

Public Class DispatcherTimer

Herança

Object

DispatcherTimer

Exemplos

O exemplo a CommandManagerseguir cria um DispatcherTimer que atualiza o conteúdo de um Label e chama o InvalidateRequerySuggested método no .

Um DispatcherTimer objeto chamado dispatcherTimer é criado. O manipulador dispatcherTimer_Tick de eventos é adicionado ao Tick evento de dispatcherTimer. O Interval é definido como 1 segundo usando um TimeSpan objeto e o temporizador é iniciado.

//  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()

O Tick manipulador de eventos atualiza um Label que exibe o segundo atual e chama InvalidateRequerySuggested o 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

Comentários

O DispatcherTimer é reavaliado na parte superior de cada Dispatcher loop.

Não há garantia de que os temporizadores sejam executados exatamente quando o intervalo de tempo ocorrer, mas eles têm a garantia de não serem executados antes que o intervalo de tempo ocorra. Isso ocorre porque DispatcherTimer as operações são colocadas na Dispatcher fila, como outras operações. Quando a DispatcherTimer operação é executada, depende dos outros trabalhos na fila e de suas prioridades.

Se um System.Timers.Timer for usado em um aplicativo WPF, vale a pena observar que o System.Timers.Timer é executado em um thread diferente do thread da interface do usuário. Para acessar objetos no thread da interface do usuário (interface do usuário), é necessário postar a operação no Dispatcher thread da interface do usuário usando Invoke ou BeginInvoke. Os motivos para usar um DispatcherTimer em vez de um System.Timers.Timer são que as DispatcherTimer execuções no mesmo thread que o Dispatcher e um DispatcherPriority pode ser definido no DispatcherTimer.

Um DispatcherTimer manterá um objeto ativo sempre que os métodos do objeto estiverem associados ao temporizador.