指定した時間だけ現在のスレッドを中断します。
Overloads Public Shared Sub Sleep( _
ByVal millisecondsTimeout As Integer _)
[C#]
public static void Sleep(intmillisecondsTimeout);
[C++]
public: static void Sleep(intmillisecondsTimeout);
[JScript]
public static function Sleep(
millisecondsTimeout : int);
パラメータ
- millisecondsTimeout
スレッドがブロックされるミリ秒数。待機中の他のスレッドが実行できるように、このスレッドの中断を示すには 0 を指定します。スレッドを無制限にブロックするには Infinite を指定します。
例外
例外の種類 | 条件 |
---|---|
ArgumentOutOfRangeException | タイムアウト値が負か、 Infinite と等しくありません。 |
解説
スレッドは、指定した時間の間は、オペレーティング システムによる実行がスケジュールされません。このメソッドは、スレッドの状態を変更して、 WaitSleepJoin の状態が含まれるようにします。
使用例
[Visual Basic, C#, C++] スリープ状態のスレッドの例を次に示します。
Imports Microsoft.VisualBasic
Imports System
Imports System.Threading
Public Class ApartmentTest
Shared Sub Main()
Dim newThread As Thread = New Thread(AddressOf ThreadMethod)
newThread.ApartmentState = ApartmentState.MTA
' The following line is ignored since
' ApartmentState can only be set once.
newThread.ApartmentState = ApartmentState.STA
Console.WriteLine("ThreadState: {0}, ApartmentState: {1}", _
newThread.ThreadState, newThread.ApartmentState)
newThread.Start()
' Wait for newThread to start and go to sleep.
Thread.Sleep(300)
Try
' This causes an exception since newThread is sleeping.
newThread.ApartmentState = ApartmentState.STA
Catch stateException As ThreadStateException
Console.WriteLine(vbCrLf & "{0} caught:" & vbCrLf & _
"Thread is not In the Unstarted or Running state.", _
stateException.GetType().Name)
Console.WriteLine("ThreadState: {0}, ApartmentState: " & _
"{1}", newThread.ThreadState, newThread.ApartmentState)
End Try
End Sub
Shared Sub ThreadMethod()
Thread.Sleep(1000)
End Sub
End Class
[C#]
using System;
using System.Threading;
class ApartmentTest
{
static void Main()
{
Thread newThread =
new Thread(new ThreadStart(ThreadMethod));
newThread.ApartmentState = ApartmentState.MTA;
// The following line is ignored since
// ApartmentState can only be set once.
newThread.ApartmentState = ApartmentState.STA;
Console.WriteLine("ThreadState: {0}, ApartmentState: {1}",
newThread.ThreadState, newThread.ApartmentState);
newThread.Start();
// Wait for newThread to start and go to sleep.
Thread.Sleep(300);
try
{
// This causes an exception since newThread is sleeping.
newThread.ApartmentState = ApartmentState.STA;
}
catch(ThreadStateException stateException)
{
Console.WriteLine("\n{0} caught:\n" +
"Thread is not in the Unstarted or Running state.",
stateException.GetType().Name);
Console.WriteLine("ThreadState: {0}, ApartmentState: {1}",
newThread.ThreadState, newThread.ApartmentState);
}
}
static void ThreadMethod()
{
Thread.Sleep(1000);
}
}
[C++]
#using <mscorlib.dll>
using namespace System;
using namespace System::Threading;
__gc class ApartmentTest
{
public :
static void ThreadMethod()
{
Thread::Sleep(1000);
}
};
void main()
{
Thread* newThread =
new Thread(new ThreadStart(0, &ApartmentTest::ThreadMethod));
newThread->ApartmentState = ApartmentState::MTA;
// The following line is ignored since
// ApartmentState can only be set once.
newThread->ApartmentState = ApartmentState::STA;
Console::WriteLine(S"ThreadState: {0}, ApartmentState: {1}",
__box(newThread->ThreadState)->ToString(),
__box(newThread->ApartmentState)->ToString());
newThread->Start();
// Wait for newThread to start and go to sleep.
Thread::Sleep(300);
try
{
// This causes an exception since newThread is sleeping.
newThread->ApartmentState = ApartmentState::STA;
}
catch(ThreadStateException* stateException)
{
Console::WriteLine(S"\n{0} caught:\n"
S"Thread is not in the Unstarted or Running state.",
stateException->GetType()->Name);
Console::WriteLine(S"ThreadState: {0}, ApartmentState: {1}",
__box(newThread->ThreadState)->ToString(),
__box(newThread->ApartmentState)->ToString());
}
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
Thread クラス | Thread メンバ | System.Threading 名前空間 | Thread.Sleep オーバーロードの一覧