AutoResetEvent クラス

リファレンス

定義

名前空間:: System.Threading

アセンブリ:: System.Threading.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

ソース:: AutoResetEvent.cs

ソース:: AutoResetEvent.cs

ソース:: AutoResetEvent.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

通知されると、1 つの待機中のスレッドを解放し、自動的にリセットするスレッド同期イベントを表します。このクラスは継承できません。

public ref class AutoResetEvent sealed : System::Threading::EventWaitHandle

public ref class AutoResetEvent sealed : System::Threading::WaitHandle

public sealed class AutoResetEvent : System.Threading.EventWaitHandle

public sealed class AutoResetEvent : System.Threading.WaitHandle

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class AutoResetEvent : System.Threading.EventWaitHandle

type AutoResetEvent = class
    inherit EventWaitHandle

type AutoResetEvent = class
    inherit WaitHandle

[<System.Runtime.InteropServices.ComVisible(true)>]
type AutoResetEvent = class
    inherit EventWaitHandle

Public NotInheritable Class AutoResetEvent
Inherits EventWaitHandle

Public NotInheritable Class AutoResetEvent
Inherits WaitHandle

継承: Object

WaitHandle

EventWaitHandle
AutoResetEvent

継承: Object

MarshalByRefObject

WaitHandle

EventWaitHandle
AutoResetEvent

継承: Object

MarshalByRefObject

WaitHandle
AutoResetEvent

属性: ComVisibleAttribute

例

次の例では、ユーザーが Enter キーを押すたびに (基底クラスで) Set メソッドを呼び出して、AutoResetEvent を使用して一度に 1 つのスレッドを解放する方法を示します。この例では、シグナル状態で作成された AutoResetEvent を待機する 3 つのスレッドを開始します。 AutoResetEvent は既にシグナル状態であるため、最初のスレッドはすぐに解放されます。これにより、後続のスレッドがブロックされるように、AutoResetEvent が非シグナル状態にリセットされます。ブロックされたスレッドは、ユーザーが Enter キーを押して一度に 1 つずつ解放するまで解放されません。

スレッドは、最初の AutoResetEventから解放された後、非シグナル状態で作成された別の AutoResetEvent を待機します。 3 つのスレッドはすべてブロックされるため、Set メソッドをすべて解放するには 3 回呼び出す必要があります。

using namespace System;
using namespace System::Threading;

ref class Example
{
private:
    static AutoResetEvent^ event_1 = gcnew AutoResetEvent(true);
    static AutoResetEvent^ event_2 = gcnew AutoResetEvent(false);

    static void ThreadProc()
    {
        String^ name = Thread::CurrentThread->Name;

        Console::WriteLine("{0} waits on AutoResetEvent #1.", name);
        event_1->WaitOne();
        Console::WriteLine("{0} is released from AutoResetEvent #1.", name);

        Console::WriteLine("{0} waits on AutoResetEvent #2.", name);
        event_2->WaitOne();
        Console::WriteLine("{0} is released from AutoResetEvent #2.", name);

        Console::WriteLine("{0} ends.", name);
    }

public:
    static void Demo()
    {
        Console::WriteLine("Press Enter to create three threads and start them.\r\n" +
                           "The threads wait on AutoResetEvent #1, which was created\r\n" +
                           "in the signaled state, so the first thread is released.\r\n" +
                           "This puts AutoResetEvent #1 into the unsignaled state.");
        Console::ReadLine();
            
        for (int i = 1; i < 4; i++)
        {
            Thread^ t = gcnew Thread(gcnew ThreadStart(&ThreadProc));
            t->Name = "Thread_" + i;
            t->Start();
        }
        Thread::Sleep(250);

        for (int i = 0; i < 2; i++)
        {
            Console::WriteLine("Press Enter to release another thread.");
            Console::ReadLine();
            event_1->Set();
            Thread::Sleep(250);
        }

        Console::WriteLine("\r\nAll threads are now waiting on AutoResetEvent #2.");
        for (int i = 0; i < 3; i++)
        {
            Console::WriteLine("Press Enter to release a thread.");
            Console::ReadLine();
            event_2->Set();
            Thread::Sleep(250);
        }

        // Visual Studio: Uncomment the following line.
        //Console::Readline();
    }
};

void main()
{
    Example::Demo();
}

/* This example produces output similar to the following:

Press Enter to create three threads and start them.
The threads wait on AutoResetEvent #1, which was created
in the signaled state, so the first thread is released.
This puts AutoResetEvent #1 into the unsignaled state.

Thread_1 waits on AutoResetEvent #1.
Thread_1 is released from AutoResetEvent #1.
Thread_1 waits on AutoResetEvent #2.
Thread_3 waits on AutoResetEvent #1.
Thread_2 waits on AutoResetEvent #1.
Press Enter to release another thread.

Thread_3 is released from AutoResetEvent #1.
Thread_3 waits on AutoResetEvent #2.
Press Enter to release another thread.

Thread_2 is released from AutoResetEvent #1.
Thread_2 waits on AutoResetEvent #2.

All threads are now waiting on AutoResetEvent #2.
Press Enter to release a thread.

Thread_2 is released from AutoResetEvent #2.
Thread_2 ends.
Press Enter to release a thread.

Thread_1 is released from AutoResetEvent #2.
Thread_1 ends.
Press Enter to release a thread.

Thread_3 is released from AutoResetEvent #2.
Thread_3 ends.
 */

using System;
using System.Threading;

// Visual Studio: Replace the default class in a Console project with 
//                the following class.
class Example
{
    private static AutoResetEvent event_1 = new AutoResetEvent(true);
    private static AutoResetEvent event_2 = new AutoResetEvent(false);

    static void Main()
    {
        Console.WriteLine("Press Enter to create three threads and start them.\r\n" +
                          "The threads wait on AutoResetEvent #1, which was created\r\n" +
                          "in the signaled state, so the first thread is released.\r\n" +
                          "This puts AutoResetEvent #1 into the unsignaled state.");
        Console.ReadLine();
            
        for (int i = 1; i < 4; i++)
        {
            Thread t = new Thread(ThreadProc);
            t.Name = "Thread_" + i;
            t.Start();
        }
        Thread.Sleep(250);

        for (int i = 0; i < 2; i++)
        {
            Console.WriteLine("Press Enter to release another thread.");
            Console.ReadLine();
            event_1.Set();
            Thread.Sleep(250);
        }

        Console.WriteLine("\r\nAll threads are now waiting on AutoResetEvent #2.");
        for (int i = 0; i < 3; i++)
        {
            Console.WriteLine("Press Enter to release a thread.");
            Console.ReadLine();
            event_2.Set();
            Thread.Sleep(250);
        }

        // Visual Studio: Uncomment the following line.
        //Console.Readline();
    }

    static void ThreadProc()
    {
        string name = Thread.CurrentThread.Name;

        Console.WriteLine("{0} waits on AutoResetEvent #1.", name);
        event_1.WaitOne();
        Console.WriteLine("{0} is released from AutoResetEvent #1.", name);

        Console.WriteLine("{0} waits on AutoResetEvent #2.", name);
        event_2.WaitOne();
        Console.WriteLine("{0} is released from AutoResetEvent #2.", name);

        Console.WriteLine("{0} ends.", name);
    }
}

/* This example produces output similar to the following:

Press Enter to create three threads and start them.
The threads wait on AutoResetEvent #1, which was created
in the signaled state, so the first thread is released.
This puts AutoResetEvent #1 into the unsignaled state.

Thread_1 waits on AutoResetEvent #1.
Thread_1 is released from AutoResetEvent #1.
Thread_1 waits on AutoResetEvent #2.
Thread_3 waits on AutoResetEvent #1.
Thread_2 waits on AutoResetEvent #1.
Press Enter to release another thread.

Thread_3 is released from AutoResetEvent #1.
Thread_3 waits on AutoResetEvent #2.
Press Enter to release another thread.

Thread_2 is released from AutoResetEvent #1.
Thread_2 waits on AutoResetEvent #2.

All threads are now waiting on AutoResetEvent #2.
Press Enter to release a thread.

Thread_2 is released from AutoResetEvent #2.
Thread_2 ends.
Press Enter to release a thread.

Thread_1 is released from AutoResetEvent #2.
Thread_1 ends.
Press Enter to release a thread.

Thread_3 is released from AutoResetEvent #2.
Thread_3 ends.
 */

Imports System.Threading

' Visual Studio: Replace the default class in a Console project with 
'                the following class.
Class Example

    Private Shared event_1 As New AutoResetEvent(True)
    Private Shared event_2 As New AutoResetEvent(False)

    <MTAThread()> _
    Shared Sub Main()
    
        Console.WriteLine("Press Enter to create three threads and start them." & vbCrLf & _
                          "The threads wait on AutoResetEvent #1, which was created" & vbCrLf & _
                          "in the signaled state, so the first thread is released." & vbCrLf & _
                          "This puts AutoResetEvent #1 into the unsignaled state.")
        Console.ReadLine()
            
        For i As Integer = 1 To 3
            Dim t As New Thread(AddressOf ThreadProc)
            t.Name = "Thread_" & i
            t.Start()
        Next
        Thread.Sleep(250)

        For i As Integer = 1 To 2
            Console.WriteLine("Press Enter to release another thread.")
            Console.ReadLine()

            event_1.Set()
            Thread.Sleep(250)
        Next

        Console.WriteLine(vbCrLf & "All threads are now waiting on AutoResetEvent #2.")
        For i As Integer = 1 To 3
            Console.WriteLine("Press Enter to release a thread.")
            Console.ReadLine()

            event_2.Set()
            Thread.Sleep(250)
        Next

        ' Visual Studio: Uncomment the following line.
        'Console.Readline()
    End Sub

    Shared Sub ThreadProc()
    
        Dim name As String = Thread.CurrentThread.Name

        Console.WriteLine("{0} waits on AutoResetEvent #1.", name)
        event_1.WaitOne()
        Console.WriteLine("{0} is released from AutoResetEvent #1.", name)

        Console.WriteLine("{0} waits on AutoResetEvent #2.", name)
        event_2.WaitOne()
        Console.WriteLine("{0} is released from AutoResetEvent #2.", name)

        Console.WriteLine("{0} ends.", name)
    End Sub
End Class

' This example produces output similar to the following:
'
'Press Enter to create three threads and start them.
'The threads wait on AutoResetEvent #1, which was created
'in the signaled state, so the first thread is released.
'This puts AutoResetEvent #1 into the unsignaled state.
'
'Thread_1 waits on AutoResetEvent #1.
'Thread_1 is released from AutoResetEvent #1.
'Thread_1 waits on AutoResetEvent #2.
'Thread_3 waits on AutoResetEvent #1.
'Thread_2 waits on AutoResetEvent #1.
'Press Enter to release another thread.
'
'Thread_3 is released from AutoResetEvent #1.
'Thread_3 waits on AutoResetEvent #2.
'Press Enter to release another thread.
'
'Thread_2 is released from AutoResetEvent #1.
'Thread_2 waits on AutoResetEvent #2.
'
'All threads are now waiting on AutoResetEvent #2.
'Press Enter to release a thread.
'
'Thread_2 is released from AutoResetEvent #2.
'Thread_2 ends.
'Press Enter to release a thread.
'
'Thread_1 is released from AutoResetEvent #2.
'Thread_1 ends.
'Press Enter to release a thread.
'
'Thread_3 is released from AutoResetEvent #2.
'Thread_3 ends.

注釈

AutoResetEvent、ManualResetEvent、および EventWaitHandle をスレッド操作 (またはスレッドシグナル通知) に使用します。詳細については、「スレッド操作を参照してください。

スレッドは、autoResetEvent.WaitOne呼び出すことによってシグナルを待機します。が非シグナル状態の場合、スレッドは AutoResetEvent.Set 呼び出されるまでブロックします。 Set を呼び出すと、待機中のスレッドを解放する AutoResetEvent が通知されます。 AutoResetEvent は、Reset が呼び出されるか、1 つの待機中のスレッドが解放されるまで通知されたままになります。その時点で、通知されていない状態に自動的に戻ります。

AutoResetEvent がシグナル状態になったときにスレッドが待機していない場合、スレッドがシグナルを観察するまで (WaitOneを呼び出すことによって) 状態はシグナル状態のままになります。そのスレッドはブロックしません。AutoResetEvent はすぐにスレッドを解放し、非シグナル状態に戻ります。

大事な

Set メソッドを呼び出すたびにスレッドが解放される保証はありません。 2 つの呼び出しが近すぎて、スレッドが解放される前に 2 回目の呼び出しが行われる場合、1 つのスレッドのみが解放されます。これは、2 回目の呼び出しが行われなかったかのように表示されます。また、待機しているスレッドがなく、AutoResetEvent が既に通知されているときに Set が呼び出された場合、呼び出しは無効になります。

AutoResetEvent の初期状態を制御するには、コンストラクターにブール値を渡します。初期状態が通知される場合は true、それ以外の場合は false。

AutoResetEvent は、staticWaitAll メソッドと WaitAny メソッドでも使用できます。

AutoResetEvent は、EventWaitHandle クラスから派生します。 AutoResetEvent は、EventResetMode.AutoResetで作成された EventWaitHandle と機能的に同等です。

手記

AutoResetEvent クラスとは異なり、EventWaitHandle クラスは、名前付きシステム同期イベントへのアクセスを提供します。

大事な

この型は、IDisposable インターフェイスを実装します。型の使用が完了したら、直接または間接的に破棄する必要があります。型を直接破棄するには、try/catch ブロックでその Dispose メソッドを呼び出します。間接的に破棄するには、using (C#) や Using (Visual Basic) などの言語コンストラクトを使用します。詳細については、IDisposable インターフェイスページの「IDisposable を実装するオブジェクトの使用」セクションを参照してください。

コンストラクター

AutoResetEvent(Boolean)

初期状態を signaled に設定するかどうかを示すブール値を使用して、AutoResetEvent クラスの新しいインスタンスを初期化します。

フィールド

WaitTimeout

待機ハンドルのいずれかが通知される前に、WaitAny(WaitHandle[], Int32, Boolean) 操作がタイムアウトしたことを示します。このフィールドは定数です。

(継承元 WaitHandle)

プロパティ

Handle	古い. 古い. ネイティブオペレーティングシステムハンドルを取得または設定します。 (継承元 WaitHandle)
SafeWaitHandle	ネイティブオペレーティングシステムハンドルを取得または設定します。 (継承元 WaitHandle)

メソッド

Close()	現在の WaitHandleによって保持されているすべてのリソースを解放します。 (継承元 WaitHandle)
CreateObjRef(Type)	リモートオブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	WaitHandle クラスの現在のインスタンスで使用されているすべてのリソースを解放します。 (継承元 WaitHandle)
Dispose(Boolean)	派生クラスでオーバーライドされると、WaitHandleによって使用されるアンマネージリソースを解放し、必要に応じてマネージドリソースを解放します。 (継承元 WaitHandle)
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetAccessControl()	現在の EventWaitHandle オブジェクトによって表される名前付きシステムイベントのアクセス制御セキュリティを表す EventWaitHandleSecurity オブジェクトを取得します。 (継承元 EventWaitHandle)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
Reset()	イベントの状態を非署名に設定します。これにより、スレッドがブロックされます。
Reset()	イベントの状態を非署名に設定し、スレッドをブロックします。 (継承元 EventWaitHandle)
Set()	イベントの状態を signaled に設定します。これにより、最大 1 つの待機スレッドを続行できます。
Set()	イベントの状態を signaled に設定し、1 つ以上の待機中のスレッドを続行できるようにします。 (継承元 EventWaitHandle)
SetAccessControl(EventWaitHandleSecurity)	名前付きシステムイベントのアクセス制御セキュリティを設定します。 (継承元 EventWaitHandle)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
WaitOne()	現在の WaitHandle がシグナルを受信するまで、現在のスレッドをブロックします。 (継承元 WaitHandle)
WaitOne(Int32)	現在の WaitHandle がシグナルを受信するまで、32 ビット符号付き整数を使用してミリ秒単位で時間間隔を指定するまで、現在のスレッドをブロックします。 (継承元 WaitHandle)
WaitOne(Int32, Boolean)	現在の WaitHandle がシグナルを受信するまで、32 ビット符号付き整数を使用して時間間隔を指定し、待機前に同期ドメインを終了するかどうかを指定するまで、現在のスレッドをブロックします。 (継承元 WaitHandle)
WaitOne(TimeSpan)	TimeSpan を使用して時間間隔を指定して、現在のインスタンスがシグナルを受信するまで、現在のスレッドをブロックします。 (継承元 WaitHandle)
WaitOne(TimeSpan, Boolean)	TimeSpan を使用して時間間隔を指定し、待機前に同期ドメインを終了するかどうかを指定して、現在のインスタンスがシグナルを受信するまで、現在のスレッドをブロックします。 (継承元 WaitHandle)

明示的なインターフェイスの実装

IDisposable.Dispose()

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

WaitHandleで使用されているすべてのリソースを解放します。

(継承元 WaitHandle)

拡張メソッド

GetAccessControl(EventWaitHandle)	指定した `handle`のセキュリティ記述子を返します。
SetAccessControl(EventWaitHandle, EventWaitHandleSecurity)	指定したイベント待機ハンドルのセキュリティ記述子を設定します。
GetSafeWaitHandle(WaitHandle)	ネイティブオペレーティングシステムの待機ハンドルのセーフハンドルを取得します。
SetSafeWaitHandle(WaitHandle, SafeWaitHandle)	ネイティブオペレーティングシステムの待機ハンドルのセーフハンドルを設定します。

適用対象

スレッドセーフ

このクラスはスレッドセーフです。

こちらもご覧ください

WaitHandle
マネージドスレッドの
同期プリミティブの概要

次の方法で共有

AutoResetEvent クラス

定義

例

注釈

コンストラクター

フィールド

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象

スレッドセーフ

こちらもご覧ください

フィードバック

その他のリソース

次の方法で共有

AutoResetEvent クラス

定義

例

注釈

コンストラクター

フィールド

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象

スレッド セーフ

こちらもご覧ください

フィードバック

その他のリソース

スレッドセーフ