AutoResetEvent Sınıf

Tanım

Ad Alanı:

System.Threading

Bütünleştirilmiş Kod:

mscorlib.dll

Sinyal gönderildiğinde tek bir bekleyen iş parçacığı serbest bırakan ve ardından otomatik olarak sıfırlanan bir iş parçacığı eşitleme olayını temsil eder. Bu sınıf devralınamaz.

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

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

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

Public NotInheritable Class AutoResetEvent
Inherits EventWaitHandle

Devralma

Object

MarshalByRefObject

WaitHandle

EventWaitHandle

AutoResetEvent

Öznitelikler

ComVisibleAttribute

Örnekler

Aşağıdaki örnekte, kullanıcı enter tuşuna her bastığında yöntemini (temel sınıfta) çağırarak kullanarak bir kerede bir iş parçacığını serbest bırakma işlemini n nasıl kullanılacağı gösterilmektedir. Örnek, sinyalli durumda oluşturulan bir AutoResetEvent bekleyen üç iş parçacığı başlatır. İlk iş parçacığı hemen serbest bırakılır çünkü AutoResetEvent zaten sinyalli durumdadır. Bu, sonraki iş parçacıklarının engellenmesi için AutoResetEvent sinyalsiz duruma sıfırlar. Engellenen iş parçacıkları, kullanıcı Enter tuşuna basarak bunları birer birer serbest bırakana kadar serbest bırakılmaz.

İş parçacıkları ilk AutoResetEventserbest bırakıldıktan sonra, sinyalsiz durumda oluşturulan başka bir AutoResetEvent bekler. Üç iş parçacığını da engeller, bu nedenle Set yönteminin tümünü serbest bırakmak için üç kez çağrılması gerekir.

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.

Açıklamalar

İş parçacığı etkileşimi (veya iş parçacığı sinyali) için , AutoResetEventve ManualResetEvent kullanırsınızEventWaitHandle. Daha fazla bilgi için bkz. İş Parçacığı etkileşimi.

İş parçacığı, AutoResetEvent.WaitOneçağırarak sinyal bekler. işaretsiz durumdaysa, autoResetEvent.Set çağrılana kadar iş parçacığı engeller. Set çağrısı, bekleyen bir iş parçacığını serbest bırakmak için AutoResetEvent sinyaller sağlar. AutoResetEvent, Reset çağrılana veya tek bir bekleyen iş parçacığı serbest bırakılana kadar sinyalli olarak kalır ve bu sırada otomatik olarak sinyalsiz duruma döner.

AutoResetEvent sinyalli duruma geçtiğinde bekleyen iş parçacığı yoksa, bir iş parçacığı sinyali gözlemleyene kadar (WaitOneçağırarak) durum işaretlenir. Bu iş parçacığı engellemez: AutoResetEvent iş parçacığını hemen serbest bırakır ve sinyalsiz duruma döner.

Important

Set yöntemine yapılan her çağrının bir iş parçacığı serbest bırakacağının garantisi yoktur. İki çağrı birbirine çok yakınsa, böylece ikinci çağrı bir iş parçacığı serbest bırakılmadan önce gerçekleşirse, yalnızca bir iş parçacığı serbest bırakılır. sanki ikinci arama gerçekleşmemiş gibi. Ayrıca bekleyen iş parçacığı olmadığında ve Set zaten işaretlendiğinde AutoResetEvent çağrılırsa çağrının hiçbir etkisi olmaz.

Oluşturucuya boole değeri geçirerek bir AutoResetEvent ilk durumunu denetleyebilirsiniz: true ilk durum sinyalliyse ve aksi takdirde false.

AutoResetEventve static yöntemleriyle WaitAllWaitAny de kullanılabilir.

AutoResetEvent EventWaitHandle sınıfından türetilir. AutoResetEvent, EventWaitHandleile oluşturulan bir EventResetMode.AutoReset işlevsel olarak eşdeğerdir.

Note

sınıfından AutoResetEvent farklı olarak EventWaitHandle , sınıfı adlandırılmış sistem eşitleme olaylarına erişim sağlar.

Important

Bu tür IDisposable arabirimini uygular. Kullanımını bitirdiğinizde, doğrudan ya da dolaylı yoldan atmalısınız. Türü doğrudan atabilmek için, bir Disposetry/ bloğunda catch yöntemini çağırın. Bunu dolaylı olarak atmak için using (C#'de) veya Using (Visual Basic'te) gibi bir dil yapısı kullanın. Daha fazla bilgi için IDisposable arabirimi sayfasındaki "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne bakın.

Oluşturucular

Name	Description
AutoResetEvent(Boolean)	İlk durumun işaretlendi olarak ayarlanıp ayarlanmayacağını AutoResetEvent belirten boole değeriyle sınıfının yeni bir örneğini başlatır.

Alanlar

Name	Description
WaitTimeout	Bekleme tutamaçlarından herhangi biri işaretlenmeden önce bir WaitAny(WaitHandle[], Int32, Boolean) işlemin zaman aşımına uğramasını gösterir. Bu alan sabittir. (Devralındığı yer: WaitHandle)

Özellikler

Name	Description
Handle	Geçersiz. Yerel işletim sistemi tutamacını alır veya ayarlar. (Devralındığı yer: WaitHandle)
SafeWaitHandle	Yerel işletim sistemi tutamacını alır veya ayarlar. (Devralındığı yer: WaitHandle)

Yöntemler

Name	Description
Close()	Geçerli WaitHandletarafından tutulan tüm kaynakları serbest bırakır. (Devralındığı yer: WaitHandle)
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Sınıfın geçerli örneği WaitHandle tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: WaitHandle)
Dispose(Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, tarafından WaitHandlekullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: WaitHandle)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetAccessControl()	EventWaitHandleSecurity Geçerli EventWaitHandle nesne tarafından temsil edilen adlandırılmış sistem olayı için erişim denetimi güvenliğini temsil eden bir nesne alır. (Devralındığı yer: EventWaitHandle)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
Reset()	Olayın durumunu işaretsiz olarak ayarlar ve iş parçacıklarının engellenmesine neden olur. (Devralındığı yer: EventWaitHandle)
Set()	Bir veya daha fazla bekleyen iş parçacığının devam etmelerine olanak tanıyarak olayın durumunu işaretlendi olarak ayarlar. (Devralındığı yer: EventWaitHandle)
SetAccessControl(EventWaitHandleSecurity)	Adlandırılmış bir sistem olayı için erişim denetimi güvenliğini ayarlar. (Devralındığı yer: EventWaitHandle)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
WaitOne()	Geçerli iş parçacığını, geçerli WaitHandle bir sinyal alıncaya kadar engeller. (Devralındığı yer: WaitHandle)
WaitOne(Int32, Boolean)	Geçerli iş parçacığını, zaman aralığını belirtmek ve beklemeden önce eşitleme etki alanından çıkılıp çıkılmayacağını belirtmek için 32 bit imzalı bir tamsayı kullanarak bir WaitHandle sinyal alana kadar geçerli iş parçacığını engeller. (Devralındığı yer: WaitHandle)
WaitOne(Int32)	Geçerli iş parçacığını, milisaniye cinsinden zaman aralığını belirtmek için 32 bit imzalı bir tamsayı kullanarak, geçerli WaitHandle iş parçacığını bir sinyal alana kadar engeller. (Devralındığı yer: WaitHandle)
WaitOne(TimeSpan, Boolean)	Geçerli örnek bir sinyal alana kadar geçerli iş parçacığını engeller; zaman aralığını belirtmek için kullanarak TimeSpan ve beklemeden önce eşitleme etki alanından çıkılıp çıkılmayacağını belirtir. (Devralındığı yer: WaitHandle)
WaitOne(TimeSpan)	Geçerli örnek bir sinyal alana kadar geçerli iş parçacığını engeller ve zaman aralığını belirtmek için bir TimeSpan kullanılır. (Devralındığı yer: WaitHandle)

Uzantı Metotları

Name	Description
GetSafeWaitHandle(WaitHandle)	Yerel işletim sistemi bekleme tutamacını güvenli tutamacını alır.
SetSafeWaitHandle(WaitHandle, SafeWaitHandle)	Yerel işletim sistemi bekleme tutamacı için güvenli bir tanıtıcı ayarlar.

İş Parçacığı Güvenliği

Bu sınıf iş parçacığı güvenlidir.

Ayrıca bkz.

• WaitHandle
• Yönetilen İş Parçacıkları
• Eşitleme temel bilgilerine genel bakış