Thread.Sleep

.NET Framework クラス ライブラリ リファレンス

Thread.Sleep メソッド (TimeSpan)

指定した時間の間現在のスレッドをブロックします。

名前空間: System.Threading
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub Sleep
 ( _
    timeout As TimeSpan _
)

Visual Basic (使用法)

Dim timeout As TimeSpan

Thread.Sleep(timeout)

C#

public static void Sleep
 (
    TimeSpan timeout
)

C++

public:
static void Sleep (
    TimeSpan timeout
)

J#

public static void Sleep
 (
    TimeSpan timeout
)

JScript

public static function Sleep
 (
    timeout : TimeSpan
)

パラメータ

timeout

スレッドがブロックされる時間に設定される TimeSpan。待機中の他のスレッドが実行できるようにこのスレッドの中断を示すには 0 を指定します。スレッドを無制限にブロックするには Infinite を指定します。

例外

例外の種類	条件
ArgumentOutOfRangeException	timeout の値が負で、ミリ秒単位の Timeout.Infinite と等しくないか、または MaxValue ミリ秒より大きいです。

解説

スレッドは、指定した時間の間は、オペレーティング システムによる実行がスケジュールされません。このメソッドは、スレッドの状態を変更して、WaitSleepJoin の状態が含まれるようにします。

Sleep のこのオーバーロードは、timeout のミリ秒の整数部の合計を使用します。ミリ秒の小数部は、切り捨てられます。

このメソッドは、標準 COM/SendMessage ポンピングを実行しません。

メモ
STAThreadAttribute を持つスレッドでスリープする必要があり、標準 COM/SendMessage ポンピングを実行する必要がある場合は、タイムアウト間隔を指定する Join メソッドのいずれかのオーバーロードを使用することを検討してください。

使用例

Sleep メソッドで TimeSpan 値を使用する方法の例を次に示します。

Visual Basic

Imports System
Imports System.Threading

Public Class Test

    Shared waitTime As New
 TimeSpan(0, 0, 1)

    <MTAThread> _
    Shared Sub Main() 
        Dim newThread As New
 Thread(AddressOf Work)
        newThread.Start()

        If newThread.Join( _
            TimeSpan.op_Addition(waitTime, waitTime)) Then

            Console.WriteLine("New thread terminated.")
        Else
            Console.WriteLine("Join timed out.")
        End If
    End Sub

    Shared Sub Work()
        Thread.Sleep(waitTime)
    End Sub

End Class

C#

using System;
using System.Threading;

class Test
{
    static TimeSpan waitTime = new TimeSpan(0,
 0, 1);

    public static void Main()
 
    {
        Thread newThread = 
            new Thread(new ThreadStart(Work));
        newThread.Start();

        if(newThread.Join(waitTime + waitTime))
        {
            Console.WriteLine("New thread terminated.");
        }
        else
        {
            Console.WriteLine("Join timed out.");
        }
    }

    static void Work()
    {
        Thread.Sleep(waitTime);
    }
}

C++

using namespace System;
using namespace System::Threading;
static TimeSpan waitTime = TimeSpan(0,0,1);
ref class Test
{
public:
   static void Work()
   {
      Thread::Sleep( waitTime );
   }

};

int main()
{
   Thread^ newThread = gcnew Thread( gcnew ThreadStart( Test::Work ) );
   newThread->Start();
   if ( newThread->Join( waitTime + waitTime ) )
   {
      Console::WriteLine( "New thread terminated." );
   }
   else
   {
      Console::WriteLine( "Join timed out." );
   }
}

J#

import System.*;
import System.Threading.*;
import System.Threading.Thread;

class Test
{
    private static TimeSpan waitTime = new
 TimeSpan(0, 0, 1);

    public static void main(String[]
 args)
    {
        Thread newThread = new Thread(new ThreadStart(Work));

        newThread.Start();
        if (newThread.Join((waitTime.Add(waitTime)))) {
            Console.WriteLine("New thread terminated.");
        }
        else {
            Console.WriteLine("Join timed out.");
        }
    } //main

    static void Work()
    {
        Thread.Sleep(waitTime);
    } //Work
} //Test

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Thread クラス
Thread メンバ
System.Threading 名前空間

Thread.Sleep メソッド (Int32)

指定した時間だけ現在のスレッドを中断します。

名前空間: System.Threading
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub Sleep
 ( _
    millisecondsTimeout As Integer _
)

Visual Basic (使用法)

Dim millisecondsTimeout As Integer

Thread.Sleep(millisecondsTimeout)

C#

public static void Sleep
 (
    int millisecondsTimeout
)

C++

public:
static void Sleep (
    int millisecondsTimeout
)

J#

public static void Sleep
 (
    int millisecondsTimeout
)

JScript

public static function Sleep
 (
    millisecondsTimeout : int
)

パラメータ

millisecondsTimeout

スレッドがブロックされるミリ秒数。待機中の他のスレッドが実行できるように、このスレッドの中断を示すには 0 を指定します。スレッドを無制限にブロックするには Infinite を指定します。

例外

例外の種類	条件
ArgumentOutOfRangeException	タイムアウト値が負か、Infinite と等しくありません。

解説

スレッドは、指定した時間の間は、オペレーティング システムによる実行がスケジュールされません。このメソッドは、スレッドの状態を変更して、WaitSleepJoin の状態が含まれるようにします。

このメソッドは、標準 COM/SendMessage ポンピングを実行しません。

メモ
STAThreadAttribute を持つスレッドでスリープする必要があり、標準 COM/SendMessage ポンピングを実行する必要がある場合は、タイムアウト間隔を指定する Join メソッドのいずれかのオーバーロードを使用することを検討してください。

使用例

スリープ状態のスレッドの例を次に示します。

Visual Basic

Imports Microsoft.VisualBasic
Imports System
Imports System.Threading

Public Class ApartmentTest

    <MTAThread> _
    Shared Sub Main()
    
        Dim newThread As Thread = New
 Thread(AddressOf ThreadMethod)
        newThread.SetApartmentState(ApartmentState.MTA)

        ' The following line is ignored since 
        ' ApartmentState can only be set once.
        newThread.SetApartmentState(ApartmentState.STA)

        Console.WriteLine("ThreadState: {0}, ApartmentState: {1}",
 _
            newThread.ThreadState, newThread.GetApartmentState())

        newThread.Start()

        ' Wait for newThread to start and go to sleep.
        Thread.Sleep(300)
        Try
            ' This causes an exception since newThread is sleeping.
            newThread.SetApartmentState(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.GetApartmentState())
        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.SetApartmentState(ApartmentState.MTA);

        // The following line is ignored since 
        // ApartmentState can only be set once.
        newThread.SetApartmentState(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.SetApartmentState(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.GetApartmentState());
        }
    }

    static void ThreadMethod()
    {
        Thread.Sleep(1000);
    }
}

C++

using namespace System;
using namespace System::Threading;
ref class ApartmentTest
{
public:
   static void ThreadMethod()
   {
      Thread::Sleep( 1000 );
   }

};

int main()
{
   Thread^ newThread = gcnew Thread( gcnew ThreadStart( &ApartmentTest::ThreadMethod
 ) );
   newThread->SetApartmentState(ApartmentState::MTA);
   
   // The following line is ignored since 
   // ApartmentState can only be set once.
   newThread->SetApartmentState(ApartmentState::STA);
   Console::WriteLine( "ThreadState: {0}, ApartmentState: {1}", newThread->ThreadState.ToString(),
 newThread->GetApartmentState().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->SetApartmentState(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.ToString(),
 newThread->GetApartmentState().ToString() );
   }

}

J#

import System.*;
import System.Threading.*;
import System.Threading.Thread;    

class ApartmentTest
{
    public static void main(String[]
 args)
    {
        Thread newThread = new Thread(new ThreadStart(ThreadMethod));

        newThread.set_ApartmentState(ApartmentState.MTA);

        // The following line is ignored since 
        // ApartmentState can only be set once.
        newThread.set_ApartmentState(ApartmentState.STA);
        Console.WriteLine("ThreadState: {0}, ApartmentState: {1}",
                        newThread.get_ThreadState(),
                        newThread.get_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.set_ApartmentState(ApartmentState.STA);
        }
        catch (ThreadStateException stateException) {
            Console.WriteLine("\n{0} caught:\n" + 
                "Thread is not in the Unstarted or Running
 state.", 
                stateException.GetType().get_Name());
            Console.WriteLine("ThreadState: {0}, ApartmentState: {1}",
                newThread.get_ThreadState(),newThread.get_ApartmentState());
        }
    } //main

    static void ThreadMethod()
    {
        Thread.Sleep(1000);
    } //ThreadMethod
} //ApartmentTest

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Thread クラス
Thread メンバ
System.Threading 名前空間

Thread.Sleep メソッド

指定したミリ秒数の間現在のスレッドをブロックします。
オーバーロードの一覧

名前	説明
Thread.Sleep (Int32)	指定した時間だけ現在のスレッドを中断します。 .NET Compact Framework によってサポートされています。
Thread.Sleep (TimeSpan)	指定した時間の間現在のスレッドをブロックします。

参照

関連項目

Thread クラス
Thread メンバ
System.Threading 名前空間