概述
AutoResetEvent 允许线程通过发信号互相通信。 通常,当线程需要独占访问资源时使用该类。
线程通过调用 AutoResetEvent 上的 WaitOne 来等待信号。 如果 AutoResetEvent 为非终止状态,则线程会被阻止,并等待当前控制资源的线程通过调用 Set 来通知资源可用。
调用 Set 向 AutoResetEvent 发信号以释放等待线程。 AutoResetEvent 将保持终止状态,直到一个正在等待的线程被释放,然后自动返回非终止状态。 如果没有任何线程在等待,则状态将无限期地保持为终止状态。
如果当 AutoResetEvent 为终止状态时线程调用 WaitOne,则线程不会被阻止。 AutoResetEvent 将立即释放线程并返回到非终止状态。
ManualResetEvent 允许线程通过发信号互相通信。 通常,此通信涉及一个线程在其他线程进行之前必须完成的任务。
当一个线程开始一个活动(此活动必须完成后,其他线程才能开始)时,它调用 Reset 以将 ManualResetEvent 置于非终止状态。 此线程可被视为控制 ManualResetEvent。 调用 ManualResetEvent 上的 WaitOne 的线程将阻止,并等待信号。 当控制线程完成活动时,它调用Set 以发出等待线程可以继续进行的信号。 并释放所有等待线程。
一旦它被终止,ManualResetEvent 将保持终止状态,直到它被手动重置。 即对 WaitOne 的调用将立即返回。
可以通过将布尔值传递给构造函数来控制 ManualResetEvent 的初始状态,如果初始状态处于终止状态,为 true;否则为 false。
ManualResetEvent 也可以同 staticWaitAll 和 WaitAny 方法一起使用。
生活中的例子
AutoResetEvent :在上海坐地铁,检票口有个刷卡的通道,一次只能一个人刷卡后通过,而我过后,它又是关闭的,另一个人又得再刷卡.一次操作,只有一个事件,这时就是非终止状态,一般是用来同步访问资源.
ManualResetEvent :公司园区的大门很大,一次可以多人通过。
ManualResetEvent和AutoResetEvent 比较
ManualResetEvent和AutoResetEvent都继承自EventWaitHandler,它们的唯一区别就在于父类 EventWaitHandler的构造函数参数EventResetMode不同,这样我们只要弄清了参数EventResetMode值不同时,EventWaitHandler类控制线程同步的行为有什么不同,两个子类也就清楚了。
共同点:
A、Set方法将事件状态设置为终止状态,允许一个或多个等待线程继续;Reset方法将事件状态设置为非终止状态,导致线程阻止;WaitOne阻止当前线程,直到当前线程的WaitHandler收到事件信号。
B、可以通过构造函数的参数值来决定其初始状态,若为true则事件为终止状态从而使线程为非阻塞状态,为false则线程为阻塞状态。
C、如果某个线程调用WaitOne方法,则当事件状态为终止状态时,该线程会得到信号,继续向下执行。
不同点:
A、AutoResetEvent.WaitOne()每次只允许一个线程进入,当某个线程得到信号后,AutoResetEvent会自动又将信号置为不发送状态,则其他调用WaitOne的线程只有继续等待,也就是说AutoResetEvent一次只唤醒一个线程;
B、ManualResetEvent则可以唤醒多个线程,因为当某个线程调用了ManualResetEvent.Set()方法后,其他调用WaitOne的线程获得信号得以继续执行,而ManualResetEvent不会自动将信号置为不发送。
C、也就是说,除非手工调用了ManualResetEvent.Reset()方法,则ManualResetEvent将一直保持有信号状态,ManualResetEvent也就可以同时唤醒多个线程继续执行。
先看下AutoResetEvent 的代码
1
2
3
4
5
6
7
8
9
10
11
12
13
|
namespace
System.Threading {
using
System;
using
System.Security.Permissions;
using
System.Runtime.InteropServices;
[HostProtection(Synchronization=
true
, ExternalThreading=
true
)]
[System.Runtime.InteropServices.ComVisible(
true
)]
public
sealed
class
AutoResetEvent : EventWaitHandle
{
public
AutoResetEvent(
bool
initialState) :
base
(initialState,EventResetMode.AutoReset){ }
}
}
|
再来看下EventWaitHandle的代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
namespace
System.Threading
{
using
System;
using
System.Threading;
using
System.Runtime.CompilerServices;
using
System.Security.Permissions;
using
System.IO;
using
Microsoft.Win32;
using
Microsoft.Win32.SafeHandles;
using
System.Runtime.InteropServices;
using
System.Runtime.Versioning;
#if !FEATURE_PAL
using
System.Security.AccessControl;
#endif
[HostProtection(Synchronization=
true
, ExternalThreading=
true
)]
[ComVisibleAttribute(
true
)]
public
class
EventWaitHandle : WaitHandle
{
[ResourceExposure(ResourceScope.None)]
[ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)]
public
EventWaitHandle(
bool
initialState, EventResetMode mode) :
this
(initialState,mode,
null
) { }
[SecurityPermissionAttribute(SecurityAction.LinkDemand,Flags=SecurityPermissionFlag.UnmanagedCode)]
[ResourceExposure(ResourceScope.Machine)]
[ResourceConsumption(ResourceScope.Machine)]
public
EventWaitHandle(
bool
initialState, EventResetMode mode,
string
name)
{
if
(
null
!= name && System.IO.Path.MAX_PATH < name.Length)
{
throw
new
ArgumentException(Environment.GetResourceString(
"Argument_WaitHandleNameTooLong"
,name));
}
SafeWaitHandle _handle =
null
;
switch
(mode)
{
case
EventResetMode.ManualReset:
_handle = Win32Native.CreateEvent(
null
,
true
, initialState, name);
break
;
case
EventResetMode.AutoReset:
_handle = Win32Native.CreateEvent(
null
,
false
, initialState, name);
break
;
default
:
throw
new
ArgumentException(Environment.GetResourceString(
"Argument_InvalidFlag"
,name));
};
if
(_handle.IsInvalid)
{
int
errorCode = Marshal.GetLastWin32Error();
_handle.SetHandleAsInvalid();
if
(
null
!= name && 0 != name.Length && Win32Native.ERROR_INVALID_HANDLE == errorCode)
throw
new
WaitHandleCannotBeOpenedException(Environment.GetResourceString(
"Threading.WaitHandleCannotBeOpenedException_InvalidHandle"
,name));
__Error.WinIOError(errorCode,
""
);
}
SetHandleInternal(_handle);
}
[SecurityPermissionAttribute(SecurityAction.LinkDemand,Flags=SecurityPermissionFlag.UnmanagedCode)]
[ResourceExposure(ResourceScope.Machine)]
[ResourceConsumption(ResourceScope.Machine)]
public
EventWaitHandle(
bool
initialState, EventResetMode mode,
string
name,
out
bool
createdNew)
#if !FEATURE_PAL
:
this
(initialState, mode, name,
out
createdNew,
null
)
{
}
[SecurityPermissionAttribute(SecurityAction.LinkDemand,Flags=SecurityPermissionFlag.UnmanagedCode)]
[ResourceExposure(ResourceScope.Machine)]
[ResourceConsumption(ResourceScope.Machine)]
public
unsafe
EventWaitHandle(
bool
initialState, EventResetMode mode,
string
name,
out
bool
createdNew, EventWaitHandleSecurity eventSecurity)
#endif
{
if
(
null
!= name && System.IO.Path.MAX_PATH < name.Length)
{
throw
new
ArgumentException(Environment.GetResourceString(
"Argument_WaitHandleNameTooLong"
,name));
}
Win32Native.SECURITY_ATTRIBUTES secAttrs =
null
;
#if !FEATURE_PAL
// For ACL's, get the security descriptor from the EventWaitHandleSecurity.
if
(eventSecurity !=
null
) {
secAttrs =
new
Win32Native.SECURITY_ATTRIBUTES();
secAttrs.nLength = (
int
)Marshal.SizeOf(secAttrs);
byte
[] sd = eventSecurity.GetSecurityDescriptorBinaryForm();
byte
* pSecDescriptor =
stackalloc
byte
[sd.Length];
Buffer.memcpy(sd, 0, pSecDescriptor, 0, sd.Length);
secAttrs.pSecurityDescriptor = pSecDescriptor;
}
#endif
SafeWaitHandle _handle =
null
;
Boolean isManualReset;
switch
(mode)
{
case
EventResetMode.ManualReset:
isManualReset =
true
;
break
;
case
EventResetMode.AutoReset:
isManualReset =
false
;
break
;
default
:
throw
new
ArgumentException(Environment.GetResourceString(
"Argument_InvalidFlag"
,name));
};
_handle = Win32Native.CreateEvent(secAttrs, isManualReset, initialState, name);
int
errorCode = Marshal.GetLastWin32Error();
if
(_handle.IsInvalid)
{
_handle.SetHandleAsInvalid();
if
(
null
!= name && 0 != name.Length && Win32Native.ERROR_INVALID_HANDLE == errorCode)
throw
new
WaitHandleCannotBeOpenedException(Environment.GetResourceString(
"Threading.WaitHandleCannotBeOpenedException_InvalidHandle"
,name));
__Error.WinIOError(errorCode, name);
}
createdNew = errorCode != Win32Native.ERROR_ALREADY_EXISTS;
SetHandleInternal(_handle);
}
private
EventWaitHandle(SafeWaitHandle handle)
{
SetHandleInternal(handle);
}
[SecurityPermissionAttribute(SecurityAction.LinkDemand,Flags=SecurityPermissionFlag.UnmanagedCode)]
[ResourceExposure(ResourceScope.Machine)]
[ResourceConsumption(ResourceScope.Machine)]
public
static
EventWaitHandle OpenExisting(
string
name)
{
#if !FEATURE_PAL
return
OpenExisting(name, EventWaitHandleRights.Modify | EventWaitHandleRights.Synchronize);
}
[SecurityPermissionAttribute(SecurityAction.LinkDemand,Flags=SecurityPermissionFlag.UnmanagedCode)]
[ResourceExposure(ResourceScope.Machine)]
[ResourceConsumption(ResourceScope.Machine)]
public
static
EventWaitHandle OpenExisting(
string
name, EventWaitHandleRights rights)
{
#endif // !FEATURE_PAL
if
(name ==
null
)
{
throw
new
ArgumentNullException(
"name"
, Environment.GetResourceString(
"ArgumentNull_WithParamName"
));
}
if
(name.Length == 0)
{
throw
new
ArgumentException(Environment.GetResourceString(
"Argument_EmptyName"
),
"name"
);
}
if
(
null
!= name && System.IO.Path.MAX_PATH < name.Length)
{
throw
new
ArgumentException(Environment.GetResourceString(
"Argument_WaitHandleNameTooLong"
,name));
}
#if FEATURE_PAL
SafeWaitHandle myHandle = Win32Native.OpenEvent(Win32Native.EVENT_MODIFY_STATE | Win32Native.SYNCHRONIZE,
false
, name);
#else
SafeWaitHandle myHandle = Win32Native.OpenEvent((
int
) rights,
false
, name);
#endif
if
(myHandle.IsInvalid)
{
int
errorCode = Marshal.GetLastWin32Error();
if
(Win32Native.ERROR_FILE_NOT_FOUND == errorCode || Win32Native.ERROR_INVALID_NAME == errorCode)
throw
new
WaitHandleCannotBeOpenedException();
if
(
null
!= name && 0 != name.Length && Win32Native.ERROR_INVALID_HANDLE == errorCode)
throw
new
WaitHandleCannotBeOpenedException(Environment.GetResourceString(
"Threading.WaitHandleCannotBeOpenedException_InvalidHandle"
,name));
//this is for passed through Win32Native Errors
__Error.WinIOError(errorCode,
""
);
}
return
new
EventWaitHandle(myHandle);
}
public
bool
Reset()
{
bool
res = Win32Native.ResetEvent(safeWaitHandle);
if
(!res)
__Error.WinIOError();
return
res;
}
public
bool
Set()
{
bool
res = Win32Native.SetEvent(safeWaitHandle);
if
(!res)
__Error.WinIOError();
return
res;
}
#if !FEATURE_PAL
public
EventWaitHandleSecurity GetAccessControl()
{
return
new
EventWaitHandleSecurity(safeWaitHandle, AccessControlSections.Access | AccessControlSections.Owner | AccessControlSections.Group);
}
public
void
SetAccessControl(EventWaitHandleSecurity eventSecurity)
{
if
(eventSecurity ==
null
)
throw
new
ArgumentNullException(
"eventSecurity"
);
eventSecurity.Persist(safeWaitHandle);
}
#endif
}
}
|
再来看下ManualResetEvent的代码
1
2
3
4
5
6
7
8
9
10
11
12
13
|
namespace
System.Threading {
using
System;
using
System.Security.Permissions;
using
System.Runtime.InteropServices;
[HostProtection(Synchronization=
true
, ExternalThreading=
true
)]
[System.Runtime.InteropServices.ComVisible(
true
)]
public
sealed
class
ManualResetEvent : EventWaitHandle
{
public
ManualResetEvent(
bool
initialState) :
base
(initialState,EventResetMode.ManualReset){}
}
}
|
其实这两个的差别就是AutoResetEvent是base(initialState,EventResetMode.AutoReset)而ManualResetEvent是base(initialState,EventResetMode.ManualReset).
AutoResetEvent是操作单个线程的,而ManualResetEvent可以操作多个线程.
AutoResetEvent开发示例
在主线程运行后,新开一个新线程,由新线程来控制主线程的等待和执行.
类关系图
代码实现
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
//===============================================================================
//作者:Spring Yang
//日期:2011-10-12
//===============================================================================
namespace
TestMultipleThread
{
using
System;
using
System.Collections.Generic;
using
System.Threading;
public
class
ThreadWork
{
private
MainContext mainContext;
private
ContextCache contextCache;
public
ThreadWork()
{
contextCache = ContextCache.GetContextCache();
mainContext = contextCache.GetContextByUserId(
"001"
);
}
public
void
Sum()
{
Console.WriteLine(
string
.Format(
"this is thread ID {0} execute"
, Thread.CurrentThread.ManagedThreadId));
for
(
int
i = 0; i < 10; i++)
{
Thread.Sleep(10);
}
if
(mainContext !=
null
&& mainContext.IsCrawlWait ==
false
)
{
mainContext.IsNTFSEvent =
true
;
while
(mainContext.IsCrawlWait)
{
Thread.Sleep(25);
}
Console.WriteLine(
"main thread is wait"
);
Thread.Sleep(10000);
Console.WriteLine(
"main thread is start"
);
mainContext.IsNTFSEvent =
false
;
mainContext.SetThread();
}
}
}
class
Program
{
public
static
void
Main()
{
MainContext mainContext =
new
MainContext(
"001"
);
mainContext.Save();
//新开一个线程
ThreadWork threadWork =
new
ThreadWork();
ThreadStart myThreadDelegate =
new
ThreadStart(threadWork.Sum);
Thread myThread =
new
Thread(myThreadDelegate);
myThread.Start();
for
(
int
i = 0; i < 100; i++)
{
if
(mainContext.IsNTFSEvent)
mainContext.ThreadWait();
Thread.Sleep(10);
}
Console.WriteLine(
"main Thread continue"
);
Thread.Sleep(100000);
}
public
void
WriteMessage()
{
Console.WriteLine(
"Stop the main thread."
);
}
}
public
class
MainContext
{
public
string
UserId {
get
;
set
; }
//设置 AutoResetEvent
public
AutoResetEvent WaitEvent;
public
ContextCache contextCache;
//设置线程等待
public
void
ThreadWait()
{
if
(WaitEvent ==
null
) WaitEvent =
new
AutoResetEvent(
false
);
if
(IsNTFSEvent)
{
IsCrawlWait =
true
;
WaitEvent.WaitOne();
}
}
public
MainContext(
string
userID)
{
UserId = userID;
IsCrawlWait =
false
;
IsNTFSEvent =
false
;
contextCache = ContextCache.GetContextCache();
}
public
void
Save()
{
contextCache.Save(UserId,
this
);
}
public
void
SetThread()
{
if
(!IsNTFSEvent && IsCrawlWait)
{
IsCrawlWait =
false
;
WaitEvent.Set();
}
}
public
bool
IsCrawlWait {
get
;
set
; }
public
bool
IsNTFSEvent {
get
;
set
; }
}
//单例模式,保存到内存中
public
class
ContextCache
{
public
Dictionary<
string
, MainContext> dicMainContext =
new
Dictionary<
string
, MainContext>();
public
void
Save(
string
userId, MainContext mainContext)
{
dicMainContext.Add(userId, mainContext);
}
private
static
ContextCache singleContextCache;
public
MainContext GetContextByUserId(
string
userId)
{
MainContext context;
dicMainContext.TryGetValue(userId,
out
context);
return
context;
}
private
ContextCache()
{
}
public
static
ContextCache GetContextCache()
{
if
(singleContextCache ==
null
)
{
singleContextCache =
new
ContextCache();
}
return
singleContextCache;
}
}
}
|
运行结果
参考资料:
1、MSDN
2、C#多线程:深入了解线程同步lock,Monitor,Mutex,同步事件和等待句柄(中) 地址: http://dongguojun.iteye.com/blog/960586