Timer.Dispose Methode

Definitie

Alle resources die worden gebruikt door het huidige exemplaar van Timer.

Overloads

Name Description
Dispose()

Alle resources die worden gebruikt door het huidige exemplaar van Timer.

Dispose(WaitHandle)

Geeft alle resources vrij die door het huidige exemplaar van Timer en signalen worden gebruikt wanneer de timer is verwijderd.

Dispose()

Alle resources die worden gebruikt door het huidige exemplaar van Timer.

public:
 virtual void Dispose();
public void Dispose();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

Implementeringen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de resources kunt vrij maken die door een Timer.

using System;
using System.Threading;

class TimerExample
{
    static void Main()
    {
        // Create an AutoResetEvent to signal the timeout threshold in the
        // timer callback has been reached.
        var autoEvent = new AutoResetEvent(false);
        
        var statusChecker = new StatusChecker(10);

        // Create a timer that invokes CheckStatus after one second, 
        // and every 1/4 second thereafter.
        Console.WriteLine("{0:h:mm:ss.fff} Creating timer.\n", 
                          DateTime.Now);
        var stateTimer = new Timer(statusChecker.CheckStatus, 
                                   autoEvent, 1000, 250);

        // When autoEvent signals, change the period to every half second.
        autoEvent.WaitOne();
        stateTimer.Change(0, 500);
        Console.WriteLine("\nChanging period to .5 seconds.\n");

        // When autoEvent signals the second time, dispose of the timer.
        autoEvent.WaitOne();
        stateTimer.Dispose();
        Console.WriteLine("\nDestroying timer.");
    }
}

class StatusChecker
{
    private int invokeCount;
    private int  maxCount;

    public StatusChecker(int count)
    {
        invokeCount  = 0;
        maxCount = count;
    }

    // This method is called by the timer delegate.
    public void CheckStatus(Object stateInfo)
    {
        AutoResetEvent autoEvent = (AutoResetEvent)stateInfo;
        Console.WriteLine("{0} Checking status {1,2}.", 
            DateTime.Now.ToString("h:mm:ss.fff"), 
            (++invokeCount).ToString());

        if(invokeCount == maxCount)
        {
            // Reset the counter and signal the waiting thread.
            invokeCount = 0;
            autoEvent.Set();
        }
    }
}
// The example displays output like the following:
//       11:59:54.202 Creating timer.
//       
//       11:59:55.217 Checking status  1.
//       11:59:55.466 Checking status  2.
//       11:59:55.716 Checking status  3.
//       11:59:55.968 Checking status  4.
//       11:59:56.218 Checking status  5.
//       11:59:56.470 Checking status  6.
//       11:59:56.722 Checking status  7.
//       11:59:56.972 Checking status  8.
//       11:59:57.223 Checking status  9.
//       11:59:57.473 Checking status 10.
//       
//       Changing period to .5 seconds.
//       
//       11:59:57.474 Checking status  1.
//       11:59:57.976 Checking status  2.
//       11:59:58.476 Checking status  3.
//       11:59:58.977 Checking status  4.
//       11:59:59.477 Checking status  5.
//       11:59:59.977 Checking status  6.
//       12:00:00.478 Checking status  7.
//       12:00:00.980 Checking status  8.
//       12:00:01.481 Checking status  9.
//       12:00:01.981 Checking status 10.
//       
//       Destroying timer.
Imports System.Threading

Public Module Example
    Public Sub Main()
        ' Use an AutoResetEvent to signal the timeout threshold in the
        ' timer callback has been reached.
        Dim autoEvent As New AutoResetEvent(False)

        Dim statusChecker As New StatusChecker(10)

        ' Create a timer that invokes CheckStatus after one second, 
        ' and every 1/4 second thereafter.
        Console.WriteLine("{0:h:mm:ss.fff} Creating timer." & vbCrLf, 
                          DateTime.Now)
        Dim stateTimer As New Timer(AddressOf statusChecker.CheckStatus, 
                                    autoEvent, 1000, 250)

        ' When autoEvent signals, change the period to every half second.
        autoEvent.WaitOne()
        stateTimer.Change(0, 500)
        Console.WriteLine(vbCrLf & "Changing period to .5 seconds." & vbCrLf)

        ' When autoEvent signals the second time, dispose of the timer.
        autoEvent.WaitOne()
        stateTimer.Dispose()
        Console.WriteLine(vbCrLf & "Destroying timer.")
    End Sub
End Module

Public Class StatusChecker
    Dim invokeCount, maxCount As Integer 

    Sub New(count As Integer)
        invokeCount  = 0
        maxCount = count
    End Sub

    ' The timer callback method.
    Sub CheckStatus(stateInfo As Object)
        Dim autoEvent As AutoResetEvent = DirectCast(stateInfo, AutoResetEvent)
        invokeCount += 1
        Console.WriteLine("{0:h:mm:ss.fff} Checking status {1,2}.", 
                          DateTime.Now, invokeCount)
        If invokeCount = maxCount Then
            ' Reset the counter and signal the waiting thread.
            invokeCount = 0
            autoEvent.Set()
        End If
    End Sub
End Class
' The example displays output like the following:
'       11:59:54.202 Creating timer.
'       
'       11:59:55.217 Checking status  1.
'       11:59:55.466 Checking status  2.
'       11:59:55.716 Checking status  3.
'       11:59:55.968 Checking status  4.
'       11:59:56.218 Checking status  5.
'       11:59:56.470 Checking status  6.
'       11:59:56.722 Checking status  7.
'       11:59:56.972 Checking status  8.
'       11:59:57.223 Checking status  9.
'       11:59:57.473 Checking status 10.
'       
'       Changing period to .5 seconds.
'       
'       11:59:57.474 Checking status  1.
'       11:59:57.976 Checking status  2.
'       11:59:58.476 Checking status  3.
'       11:59:58.977 Checking status  4.
'       11:59:59.477 Checking status  5.
'       11:59:59.977 Checking status  6.
'       12:00:00.478 Checking status  7.
'       12:00:00.980 Checking status  8.
'       12:00:01.481 Checking status  9.
'       12:00:01.981 Checking status 10.
'       
'       Destroying timer.

Opmerkingen

Door aanroepen Dispose kunnen de resources die door de Timer resources worden gebruikt, opnieuw worden toegewezen voor andere doeleinden. Zie Dispose voor meer informatie.

Note

Callbacks kunnen optreden nadat de overbelasting van de Dispose() methode is aangeroepen, omdat de timer callbacks voor uitvoering door threadpoolthreads in de wachtrij zet. U kunt de overbelasting van de Dispose(WaitHandle) methode gebruiken om te wachten totdat alle callbacks zijn voltooid.

Zie ook

Van toepassing op

Dispose(WaitHandle)

Geeft alle resources vrij die door het huidige exemplaar van Timer en signalen worden gebruikt wanneer de timer is verwijderd.

public:
 bool Dispose(System::Threading::WaitHandle ^ notifyObject);
public bool Dispose(System.Threading.WaitHandle notifyObject);
member this.Dispose : System.Threading.WaitHandle -> bool
Public Function Dispose (notifyObject As WaitHandle) As Boolean

Parameters

notifyObject
WaitHandle

De WaitHandle te signaleren wanneer de Timer is verwijderd.

Retouren

true als de functie slaagt; anders, false.

Uitzonderingen

De notifyObject parameter is null.

Opmerkingen

Door aanroepen Dispose kunnen de resources die door de Timer resources worden gebruikt, opnieuw worden toegewezen voor andere doeleinden. Zie Dispose voor meer informatie.

Wanneer deze methode is voltooid, wordt de WaitHandle opgegeven door de notifyObject parameter aangegeven. Gebruik deze overbelasting van de Dispose methode als u wilt kunnen blokkeren totdat u zeker weet dat de timer is verwijderd. De timer wordt pas verwijderd nadat alle momenteel in de wachtrij geplaatste callbacks zijn voltooid.

Note

Als de callback de Change methode gebruikt om de dueTime parameter in te stellen op nul, kan er een racevoorwaarde optreden wanneer de Dispose(WaitHandle) methode overbelast wordt: Als de timer een nieuwe callback in de wachtrij zet voordat de methode overbelast raakt, detecteert dat er geen callbacks in de Dispose(WaitHandle) wachtrij staan, blijft deze blokkeren. Dispose(WaitHandle) Anders wordt de timer verwijderd terwijl de nieuwe callback in de wachtrij wordt geplaatst. en er wordt een ObjectDisposedException gegenereerd wanneer de nieuwe callback de Change methode aanroept.

Zie ook

Van toepassing op