Timer.Dispose Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Runtime.dll

Uvolní všechny prostředky používané aktuální instancí Timer.

Přetížení

Name	Description
Dispose()	Uvolní všechny prostředky používané aktuální instancí Timer.
Dispose(WaitHandle)	Uvolní všechny prostředky používané aktuální instancí Timer a signály, když časovač byl uvolněn.

Dispose()

Zdroj:

Timer.cs

Uvolní všechny prostředky používané aktuální instancí Timer.

public:
 virtual void Dispose();

public void Dispose();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

Implementuje

Dispose()

Příklady

Následující příklad kódu ukazuje, jak uvolnit prostředky uchovávané znakem 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.

Poznámky

Volání Dispose umožňuje, aby prostředky používané relokací Timer byly relokovány pro jiné účely. Další informace naleznete v Disposetématu Čištění nespravovaných prostředků.

Note

Zpětné volání může dojít po Dispose() volání přetížení metody, protože časovač zařadí zpětná volání pro spuštění vlákny fondu vláken. Přetížení metody můžete použít Dispose(WaitHandle) k čekání na dokončení všech zpětných volání.

Viz také

• Časovače

Dispose(WaitHandle)

Zdroj:

Timer.cs

Uvolní všechny prostředky používané aktuální instancí Timer a signály, když časovač byl uvolněn.

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

Parametry

notifyObject

WaitHandle

Signál WaitHandle , který má být signalizován, když Timer byl odstraněn.

Návraty

Boolean

truepokud je funkce úspěšná; v opačném případě . false

Výjimky

ArgumentNullException

Parametr notifyObject je null.

Poznámky

Volání Dispose umožňuje, aby prostředky používané relokací Timer byly relokovány pro jiné účely. Další informace naleznete v Disposetématu Čištění nespravovaných prostředků.

Po dokončení této metody signalizuje WaitHandle zadaný notifyObject parametr. Toto přetížení Dispose metody použijte, pokud chcete být schopni blokovat, dokud si nejste jisti, že časovač byl uvolněn. Časovač není uvolněn, dokud se nedokončily všechny aktuálně zařazené zpětná volání do fronty.

Note

Pokud zpětné volání používá metodu Change k nastavení parametru dueTime na nulu, může dojít k konfliktu časování, když Dispose(WaitHandle) je volána přetížení metody: Pokud časovač zařadí nové zpětné volání do fronty před Dispose(WaitHandle) přetížením metody zjistí, že nejsou ve frontě žádné zpětná volání, Dispose(WaitHandle) bude pokračovat v blokování; jinak časovač je uvolněn, zatímco se zařadí do fronty nového zpětného volání, a je ObjectDisposedException vyvolán, když nová zpětné volání volá metodu Change .

Viz také

• Časovače