Timer.Dispose Metódus

Definíció

Névtér:

System.Threading

Szerelvények:

netstandard.dll, System.Runtime.dll

A aktuális példánya által használt összes erőforrást felszabadítja Timer.

Túlterhelések

Name	Description
Dispose()	A aktuális példánya által használt összes erőforrást felszabadítja Timer.
Dispose(WaitHandle)	Felszabadítja az aktuális példány Timer által használt összes erőforrást, és jelzi, ha az időzítőt eltávolították.

Dispose()

Forrás:

Timer.cs

A aktuális példánya által használt összes erőforrást felszabadítja Timer.

public:
 virtual void Dispose();

public void Dispose();

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

Public Sub Dispose ()

Megvalósítás

Dispose()

Példák

Az alábbi példakód bemutatja, hogyan szabadíthatja fel az adott erőforrás által birtokolt erőforrásokat 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.

Megjegyzések

A hívás Dispose lehetővé teszi, hogy az Timer általuk használt erőforrások más célokra legyenek átcsoportosítva. További információ: DisposeNem felügyelt erőforrások tisztítása.

Note

A visszahívások a metódus túlterhelésének Dispose() meghívása után fordulhatnak elő, mivel az időzítő üzenetsorok visszahívásokat hajtanak végre a szálkészlet szálai alapján. A metódus túlterhelésével Dispose(WaitHandle) megvárhatja, amíg az összes visszahívás befejeződik.

Lásd még

• időzítők

Dispose(WaitHandle)

Forrás:

Timer.cs

Felszabadítja az aktuális példány Timer által használt összes erőforrást, és jelzi, ha az időzítőt eltávolították.

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

Paraméterek

notifyObject

WaitHandle

A WaitHandle jelzés, ha a Timer megsemmisítés megtörtént.

Válaszok

Boolean

trueha a függvény sikeres; egyéb esetben. false

Kivételek

ArgumentNullException

A notifyObject paraméter a következő null: .

Megjegyzések

A hívás Dispose lehetővé teszi, hogy az Timer általuk használt erőforrások más célokra legyenek átcsoportosítva. További információ: DisposeNem felügyelt erőforrások tisztítása.

Ha ez a metódus befejeződik, a WaitHandle paraméter által notifyObject megadott jeleket jelzi. Használja ezt a túlterhelést a Dispose módszer, ha azt szeretné, hogy képes legyen blokkolni, amíg nem biztos abban, hogy az időzítő el lett adva. Az időzítő nincs megsemmisítve, amíg az összes jelenleg várólistán lévő visszahívás be nem fejeződik.

Note

Ha a visszahívás a Change metódus használatával nullára állítja a dueTime paramétert, versenyállapot léphet fel a metódus túlterhelésének meghívásakor Dispose(WaitHandle) : Ha az időzítő egy új visszahívást állít várólistára, mielőtt Dispose(WaitHandle) a metódus túlterhelése észleli, hogy nincsenek várólistán lévő visszahívások, Dispose(WaitHandle) továbbra is blokkolni kell; ellenkező esetben az időzítőt a rendszer az új visszahívás várólistára helyezése közben dobja el, és az ObjectDisposedException új visszahívás meghívja a metódust Change .

Lásd még

• időzítők