Timer.Change Metod

Definition

Namnområde:: System.Threading

Sammansättningar:: mscorlib.dll, System.Threading.Timer.dll

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Threading.Timer.dll

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Ändrar starttiden och intervallet mellan metodanrop för en timer.

Överlagringar

Name	Description
Change(Int32, Int32)	Ändrar starttiden och intervallet mellan metodanrop för en timer med hjälp av 32-bitars signerade heltal för att mäta tidsintervall.
Change(Int64, Int64)	Ändrar starttiden och intervallet mellan metodanrop för en timer med hjälp av 64-bitars signerade heltal för att mäta tidsintervall.
Change(TimeSpan, TimeSpan)	Ändrar starttiden och intervallet mellan metodanrop för en timer med hjälp av TimeSpan värden för att mäta tidsintervall.
Change(UInt32, UInt32)	Ändrar starttiden och intervallet mellan metodanrop för en timer med hjälp av 32-bitars osignerade heltal för att mäta tidsintervall.

Change(Int32, Int32)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Ändrar starttiden och intervallet mellan metodanrop för en timer med hjälp av 32-bitars signerade heltal för att mäta tidsintervall.

public:
 bool Change(int dueTime, int period);

public bool Change(int dueTime, int period);

member this.Change : int * int -> bool

Public Function Change (dueTime As Integer, period As Integer) As Boolean

Parametrar

dueTime: Int32

Hur lång tid det tog innan återanropsmetoden som angavs när Timer skapades, i millisekunder, anropades. Ange Infinite för att förhindra att timern startas om. Ange noll (0) för att starta om timern omedelbart.

period: Int32

Tidsintervallet mellan anrop för motringningsmetoden som angavs när den Timer konstruerades, i millisekunder. Ange Infinite för att inaktivera periodisk signalering.

Returer

Boolean

trueom timern har uppdaterats. annars . false

Undantag

ObjectDisposedException

Har Timer redan tagits bort.

ArgumentOutOfRangeException

Parametern dueTime eller period är negativ och är inte lika med Infinite.

Exempel

Följande kodexempel visar hur du startar en Timer och, efter ett visst antal anrop, ändrar dess period.

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.

Kommentarer

Motringningsmetoden anropas en gång efter dueTime förflutit och därefter varje gång det tidsintervall som anges av period förflutit.

Om dueTime är noll (0) anropas återanropsmetoden omedelbart. Om dueTime är Timeout.Infiniteanropas aldrig återanropsmetoden. Timern är inaktiverad, men kan återaktiveras genom att anropa Change och ange ett positivt värde för dueTime.

Om period är noll (0) eller Timeout.Infinite, och dueTime inte Timeout.Infiniteär , anropas återanropsmetoden en gång. Timerns periodiska beteende är inaktiverat, men kan återaktiveras genom att anropa Change och ange ett positivt värde för period.

Metoden Change kan anropas från ombudet TimerCallback .

Se även

timrar

Gäller för

Change(Int64, Int64)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Ändrar starttiden och intervallet mellan metodanrop för en timer med hjälp av 64-bitars signerade heltal för att mäta tidsintervall.

public:
 bool Change(long dueTime, long period);

public bool Change(long dueTime, long period);

member this.Change : int64 * int64 -> bool

Public Function Change (dueTime As Long, period As Long) As Boolean

Parametrar

dueTime: Int64

period: Int64

Tidsintervallet mellan anrop för motringningsmetoden som angavs när den Timer konstruerades, i millisekunder. Ange Infinite för att inaktivera periodisk signalering.

Returer

Boolean

trueom timern har uppdaterats. annars . false

Undantag

ObjectDisposedException

Har Timer redan tagits bort.

ArgumentOutOfRangeException

dueTime eller period är mindre än -1.

-eller-

dueTime eller period är större än 4294967294.

Kommentarer

Motringningsmetoden anropas en gång efter dueTime förflutit och därefter varje gång det tidsintervall som anges av period förflutit.

Metoden Change kan anropas från ombudet TimerCallback .

Se även

timrar

Gäller för

Change(TimeSpan, TimeSpan)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Ändrar starttiden och intervallet mellan metodanrop för en timer med hjälp av TimeSpan värden för att mäta tidsintervall.

public:
 bool Change(TimeSpan dueTime, TimeSpan period);

public:
 virtual bool Change(TimeSpan dueTime, TimeSpan period);

public bool Change(TimeSpan dueTime, TimeSpan period);

member this.Change : TimeSpan * TimeSpan -> bool

abstract member Change : TimeSpan * TimeSpan -> bool
override this.Change : TimeSpan * TimeSpan -> bool

Public Function Change (dueTime As TimeSpan, period As TimeSpan) As Boolean

Parametrar

dueTime: TimeSpan

En TimeSpan som representerar hur lång tid som ska fördröjas innan återanropsmetoden som angavs när Timer skapades anropades. Ange InfiniteTimeSpan för att förhindra att timern startas om. Ange Zero att timern ska startas om omedelbart.

period: TimeSpan

Tidsintervallet mellan anrop för motringningsmetoden som angavs när skapades Timer . Ange InfiniteTimeSpan för att inaktivera periodisk signalering.

Returer

Boolean

trueom timern har uppdaterats. annars . false

Implementeringar

Change(TimeSpan, TimeSpan)

Undantag

ObjectDisposedException

Har Timer redan tagits bort.

ArgumentOutOfRangeException

Parametern dueTime eller period i millisekunder är mindre än -1.

NotSupportedException

Parametern dueTime eller period i millisekunder är större än 4294967294.

Exempel

Följande kodexempel visar hur du startar en Timer och, efter ett visst antal anrop, ändrar dess period.

using System;
using System.Threading;

class TimerExample
{
    static void Main()
    {
        AutoResetEvent autoEvent     = new AutoResetEvent(false);
        StatusChecker  statusChecker = new StatusChecker(10);

        // Create the delegate that invokes methods for the timer.
        TimerCallback timerDelegate = 
            new TimerCallback(statusChecker.CheckStatus);

        TimeSpan delayTime = new TimeSpan(0, 0, 1);
        TimeSpan intervalTime = new TimeSpan(0, 0, 0, 0, 250);

        // Create a timer that signals the delegate to invoke 
        // CheckStatus after one second, and every 1/4 second 
        // thereafter.
        Console.WriteLine("{0} Creating timer.\n", 
            DateTime.Now.ToString("h:mm:ss.fff"));
        Timer stateTimer = new Timer(
            timerDelegate, autoEvent, delayTime, intervalTime);

        // When autoEvent signals, change the period to every 
        // 1/2 second.
        autoEvent.WaitOne(5000, false);
        stateTimer.Change(new TimeSpan(0), 
            intervalTime + intervalTime);
        Console.WriteLine("\nChanging period.\n");

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

class StatusChecker
{
    int invokeCount, 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 Main.
            invokeCount  = 0;
            autoEvent.Set();
        }
    }
}

Imports System.Threading

Public Class TimerExample

    <MTAThread> _
    Shared Sub Main()
    
        Dim autoEvent As New AutoResetEvent(False)
        Dim statusChecker As New StatusChecker(10)

        ' Create the delegate that invokes methods for the timer.
        Dim timerDelegate As TimerCallback = _
            AddressOf statusChecker.CheckStatus

        Dim delayTime As New TimeSpan(0, 0, 1)
        Dim intervalTime As New TimeSpan(0, 0, 0, 0, 250)

        ' Create a timer that signals the delegate to invoke 
        ' CheckStatus after one second, and every 1/4 second 
        ' thereafter.
        Console.WriteLine("{0} Creating timer." & vbCrLf, _
            DateTime.Now.ToString("h:mm:ss.fff"))
        Dim stateTimer As Timer = New Timer( _
            timerDelegate, autoEvent, delayTime, intervalTime)

        ' When autoEvent signals, change the period to every 
        ' 1/2 second.
        autoEvent.WaitOne(5000, False)
        stateTimer.Change( _
            new TimeSpan(0), intervalTime.Add(intervalTime))
        Console.WriteLine(vbCrLf & "Changing period." & vbCrLf)

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

Public Class StatusChecker

    Dim invokeCount, maxCount As Integer 

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

    ' This method is called by the timer delegate.
    Sub CheckStatus(stateInfo As Object)
        Dim autoEvent As AutoResetEvent = _
            DirectCast(stateInfo, AutoResetEvent)
        invokeCount += 1
        Console.WriteLine("{0} Checking status {1,2}.", _
            DateTime.Now.ToString("h:mm:ss.fff"), _
            invokeCount.ToString())

        If invokeCount = maxCount Then
        
            ' Reset the counter and signal to stop the timer.
            invokeCount  = 0
            autoEvent.Set()
        End If
    End Sub

End Class

Kommentarer

Motringningsmetoden anropas en gång efter dueTime förflutit och därefter varje gång det tidsintervall som anges av period förflutit.

Om dueTime är TimeSpan.Zeroanropas återanropsmetoden omedelbart. Om dueTime är InfiniteTimeSpananropas aldrig återanropsmetoden. Timern är inaktiverad, men kan återaktiveras genom att anropa Change och ange ett positivt värde för dueTime.

Om period är TimeSpan.Zero eller InfiniteTimeSpan, och dueTime är positiv anropas återanropsmetoden en gång. Timerns periodiska beteende är inaktiverat, men kan återaktiveras genom att anropa Change och ange ett värde större än noll för period.

Metoden Change kan anropas från ombudet TimerCallback .

Se även

timrar

Gäller för

Change(UInt32, UInt32)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Viktigt!

Detta API uppfyller inte CLS.

Ändrar starttiden och intervallet mellan metodanrop för en timer med hjälp av 32-bitars osignerade heltal för att mäta tidsintervall.

public:
 bool Change(System::UInt32 dueTime, System::UInt32 period);

[System.CLSCompliant(false)]
public bool Change(uint dueTime, uint period);

[<System.CLSCompliant(false)>]
member this.Change : uint32 * uint32 -> bool

Public Function Change (dueTime As UInteger, period As UInteger) As Boolean

Parametrar

dueTime: UInt32

period: UInt32

Tidsintervallet mellan anrop för motringningsmetoden som angavs när den Timer konstruerades, i millisekunder. Ange Infinite för att inaktivera periodisk signalering.

Returer

Boolean

trueom timern har uppdaterats. annars . false

Attribut: CLSCompliantAttribute

Undantag

ObjectDisposedException

Har Timer redan tagits bort.

Kommentarer

Motringningsmetoden anropas en gång efter dueTime förflutit och därefter varje gång det tidsintervall som anges av period förflutit.

Metoden Change kan anropas från ombudet TimerCallback .

Se även

timrar

Gäller för

Feedback

Var den här sidan till hjälp?