Thread.Sleep Thread.Sleep Thread.Sleep Thread.Sleep Method

Definition

Hält den aktuellen Thread während des angegebenen Zeitraums an.Suspends the current thread for the specified amount of time.

Überlädt

Sleep(Int32) Sleep(Int32) Sleep(Int32) Sleep(Int32)

Hält den aktuellen Thread für die angegebene Anzahl von Millisekunden an.Suspends the current thread for the specified number of milliseconds.

Sleep(TimeSpan) Sleep(TimeSpan) Sleep(TimeSpan) Sleep(TimeSpan)

Hält den aktuellen Thread während des angegebenen Zeitraums an.Suspends the current thread for the specified amount of time.

Sleep(Int32) Sleep(Int32) Sleep(Int32) Sleep(Int32)

Hält den aktuellen Thread für die angegebene Anzahl von Millisekunden an.Suspends the current thread for the specified number of milliseconds.

public:
 static void Sleep(int millisecondsTimeout);
public static void Sleep (int millisecondsTimeout);
static member Sleep : int -> unit
Public Shared Sub Sleep (millisecondsTimeout As Integer)

Parameter

millisecondsTimeout
Int32 Int32 Int32 Int32

Die Anzahl von Millisekunden, die der Thread angehalten wird.The number of milliseconds for which the thread is suspended. Wenn der Wert des millisecondsTimeout-Arguments 0 (null) lautet, gibt der Thread den Rest seines Zeitanteils an einen beliebigen Thread mit gleicher Priorität ab, der für die Ausführung bereit ist.If the value of the millisecondsTimeout argument is zero, the thread relinquishes the remainder of its time slice to any thread of equal priority that is ready to run. Sind keine anderen Threads mit gleicher Priorität vorhanden, die ausgeführt werden können, wird die Ausführung des aktuellen Threads nicht angehalten.If there are no other threads of equal priority that are ready to run, execution of the current thread is not suspended.

Ausnahmen

Der Timeoutwert ist negativ und ungleich Infinite.The time-out value is negative and is not equal to Infinite.

Beispiele

Im folgenden Beispiel wird die Sleep Methode, um den Hauptthread der Anwendung zu blockieren.The following example uses the Sleep method to block the application's main thread.

using namespace System;
using namespace System::Threading;

int main()
{
    for (int i = 0; i < 5; i++)
    {
        Console::WriteLine("Sleep for 2 seconds.");
        Thread::Sleep(2000);
    }

    Console::WriteLine("Main thread exits.");
}

/* This example produces the following output:

Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Main thread exits.
 */
using System;
using System.Threading;

class Example
{
    static void Main()
    {
        for (int i = 0; i < 5; i++)
        {
            Console.WriteLine("Sleep for 2 seconds.");
            Thread.Sleep(2000);
        }

        Console.WriteLine("Main thread exits.");
    }
}

/* This example produces the following output:

Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Main thread exits.
 */
Imports System.Threading

Class Example

    Shared Sub Main()

        For i As Integer = 0 To 4
            Console.WriteLine("Sleep for 2 seconds.")
            Thread.Sleep(2000)
        Next

        Console.WriteLine("Main thread exits.")
    End Sub
End Class

' This example produces the following output:
'
'Sleep for 2 seconds.
'Sleep for 2 seconds.
'Sleep for 2 seconds.
'Sleep for 2 seconds.
'Sleep for 2 seconds.
'Main thread exits.

Hinweise

Der Thread wird nicht vom Betriebssystem für die angegebene Zeitdauer für die Ausführung geplant werden.The thread will not be scheduled for execution by the operating system for the amount of time specified. Diese Methode ändert den Zustand des Threads, sodass WaitSleepJoin.This method changes the state of the thread to include WaitSleepJoin.

Sie können angeben, Timeout.Infinite für die millisecondsTimeout Parameter, um das Anhalten des Threads auf unbestimmte Zeit.You can specify Timeout.Infinite for the millisecondsTimeout parameter to suspend the thread indefinitely. Allerdings wird empfohlen, dass Sie andere verwenden System.Threading Klassen wie z. B. Mutex, Monitor, EventWaitHandle, oder Semaphore stattdessen auf Threads zu synchronisieren oder Ressourcen verwalten.However, we recommend that you use other System.Threading classes such as Mutex, Monitor, EventWaitHandle, or Semaphore instead to synchronize threads or manage resources.

Die System-Zeiteinheiten in einer bestimmten Rate wird aufgerufen, die Auflösung der Uhr.The system clock ticks at a specific rate called the clock resolution. Die tatsächliche timeoutsekunden möglicherweise nicht genau dem angegebenen Timeout, da das angegebene Timeout mit Teilstrichen berichtsausführung die Verarbeitung angepasst wird.The actual timeout might not be exactly the specified timeout, because the specified timeout will be adjusted to coincide with clock ticks. Weitere Informationen zur Auflösung der Uhr und die Wartezeit, finden Sie unter den Standbymodus Funktion Thema.For more information on clock resolution and the waiting time, see the Sleep function topic. Diese Methode ruft die Standbymodus Funktion aus dem Windows-System-APIs.This method calls the Sleep function from the Windows system APIs.

Diese Methode führt keine standardmäßigen COM- und SendMessage-Pumping fortgesetzt.This method does not perform standard COM and SendMessage pumping.

Hinweis

Bei Bedarf in einem Thread, die in den Standbymodus STAThreadAttribute, aber Sie möchten Ausführen von standardmäßigen COM- und SendMessage-Pumping fortgesetzt, sollten eine der Überladungen der der Join Methode, die ein Timeoutintervall angibt.If you need to sleep on a thread that has STAThreadAttribute, but you want to perform standard COM and SendMessage pumping, consider using one of the overloads of the Join method that specifies a timeout interval.

Sleep(TimeSpan) Sleep(TimeSpan) Sleep(TimeSpan) Sleep(TimeSpan)

Hält den aktuellen Thread während des angegebenen Zeitraums an.Suspends the current thread for the specified amount of time.

public:
 static void Sleep(TimeSpan timeout);
public static void Sleep (TimeSpan timeout);
static member Sleep : TimeSpan -> unit
Public Shared Sub Sleep (timeout As TimeSpan)

Parameter

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

Der Zeitraum, während dessen der Thread angehalten wird.The amount of time for which the thread is suspended. Wenn der Wert des millisecondsTimeout-Arguments Zero lautet, gibt der Thread den Rest seines Zeitanteils an einen beliebigen Thread mit gleicher Priorität ab, der für die Ausführung bereit ist.If the value of the millisecondsTimeout argument is Zero, the thread relinquishes the remainder of its time slice to any thread of equal priority that is ready to run. Sind keine anderen Threads mit gleicher Priorität vorhanden, die ausgeführt werden können, wird die Ausführung des aktuellen Threads nicht angehalten.If there are no other threads of equal priority that are ready to run, execution of the current thread is not suspended.

Ausnahmen

Der Wert von timeout ist negativ und nicht gleich Infinite in Millisekunden oder größer als MaxValue Millisekunden.The value of timeout is negative and is not equal to Infinite in milliseconds, or is greater than MaxValue milliseconds.

Beispiele

Im folgenden Beispiel wird die Sleep(TimeSpan) -methodenüberladung, um den Hauptthread der Anwendung zwei Sekunden jedes Mal fünf Mal blockieren.The following example uses the Sleep(TimeSpan) method overload to block the application's main thread five times, for two seconds each time.

using namespace System;
using namespace System::Threading;

int main()
{
    TimeSpan interval = TimeSpan(0, 0, 2);

    for (int i = 0; i < 5; i++)
    {
        Console::WriteLine("Sleep for 2 seconds.");
        Thread::Sleep(interval);
    }

    Console::WriteLine("Main thread exits.");
}

/* This example produces the following output:

Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Main thread exits.
 */
using System;
using System.Threading;

class Example
{
    static void Main()
    {
        TimeSpan interval = new TimeSpan(0, 0, 2);

        for (int i = 0; i < 5; i++)
        {
            Console.WriteLine("Sleep for 2 seconds.");
            Thread.Sleep(interval);
        }

        Console.WriteLine("Main thread exits.");
    }
}

/* This example produces the following output:

Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Main thread exits.
 */
Imports System.Threading

Class Example

    Shared Sub Main()

        Dim interval As New TimeSpan(0, 0, 2)

        For i As Integer = 0 To 4
            Console.WriteLine("Sleep for 2 seconds.")
            Thread.Sleep(interval)
        Next

        Console.WriteLine("Main thread exits.")
    End Sub
End Class

' This example produces the following output:
'
'Sleep for 2 seconds.
'Sleep for 2 seconds.
'Sleep for 2 seconds.
'Sleep for 2 seconds.
'Sleep for 2 seconds.
'Main thread exits.

Hinweise

Der Thread wird nicht vom Betriebssystem für die angegebene Zeitdauer für die Ausführung geplant werden.The thread will not be scheduled for execution by the operating system for the amount of time specified. Diese Methode ändert den Zustand des Threads, sodass WaitSleepJoin.This method changes the state of the thread to include WaitSleepJoin.

Sie können angeben, Timeout.InfiniteTimeSpan für die timeout Parameter, um das Anhalten des Threads auf unbestimmte Zeit.You can specify Timeout.InfiniteTimeSpan for the timeout parameter to suspend the thread indefinitely. Allerdings wird empfohlen, dass Sie andere verwenden System.Threading Klassen wie z. B. Mutex, Monitor, EventWaitHandle, oder Semaphore stattdessen auf Threads zu synchronisieren oder Ressourcen verwalten.However, we recommend that you use other System.Threading classes such as Mutex, Monitor, EventWaitHandle, or Semaphore instead to synchronize threads or manage resources.

Diese Überladung der Sleep verwendet die Gesamtanzahl von ganzen Millisekunden in timeout.This overload of Sleep uses the total number of whole milliseconds in timeout. Bruchteile von Millisekunden werden verworfen.Fractional milliseconds are discarded.

Diese Methode führt keine standardmäßigen COM- und SendMessage-Pumping fortgesetzt.This method does not perform standard COM and SendMessage pumping.

Hinweis

Bei Bedarf in einem Thread, die in den Standbymodus STAThreadAttribute, aber Sie möchten Ausführen von standardmäßigen COM- und SendMessage-Pumping fortgesetzt, sollten eine der Überladungen der der Join Methode, die ein Timeoutintervall angibt.If you need to sleep on a thread that has STAThreadAttribute, but you want to perform standard COM and SendMessage pumping, consider using one of the overloads of the Join method that specifies a timeout interval.

Gilt für: