C#中的事件定义与处理

这是一个膝上型电脑使用电池的例子。电池类提提供两个事件，分别用于在电量耗尽和电量低于某一界限时引发。

一、事件的定义

首先是关于一个类的事件成员的定义，虽然.net中的事件基于委托，但在定义时还是有需要说明的地方。要为一个类定义一个事件，可以分为两个步骤。

1、定义事件要使用的委托

public delegate void LowChargeEventHandler(object sender,LowChargeEventArgs e) ;

这里，LowChargeEventHandler委托有两个参数，这是固定的，sender代表事件源，e代表事件参数（可供事件处理程序使用）

2、定义事件

public event LowChargeEventHandler LowCharge ;

这里使用了event关键字来为一个类提供事件的定义，其中，LowCharge为事件名称，LowChargeEventHandler 是一个委托类型。

二、关于EventHandle与EventArgs

EventHandle事件是.net内置的，它通常与EventArgs(所有事件数据类的基类）一块使用。如果一个事件不承载任何事件数据（即不向事件处理程序提供任何事件参数）时，我们就可以使用EventHandler与EventArgs，但是如果你的事件需要向事件处理程序提供必要的事件参数的话，那就需要定义新的委托与事件数据了。

三、示例

1、LowChargeEventArgs.cs（该文件定义了一个事件数据类，以为事件处理程序提供事件数据）

public class LowChargeEventArgs:EventArgs
{
private double _level ;

public LowChargeEventArgs()
{
//
// TODO: 在此处添加构造函数逻辑
//
}

public LowChargeEventArgs(double batteryLevel)
{
_level = batteryLevel ;
}

public double Level
{
get
{
return _level ;
}
}
}

2、LowChargeEventHandler.cs（该文件定义了一个新的事件委托）

public delegate void LowChargeEventHandler(object sender,LowChargeEventArgs e) ;

3、Battery.cs（这是关键，包含了事件的定义与引发）

public class Battery
{
//当电量降低到0.05（或以下）时表示电量耗尽
private const double DepletedLevel = 0.05 ;

//当前电量
private double _currentLevel ;

//允许使用的最小电量纸别（低于该级别，程序会引发事件并提示用户，但用户可以正常工作）
private double _mininumLevel ;

//低电量所要引发的事件
public event LowChargeEventHandler LowCharge ;

//电量耗尽时所要引发的事件
public event EventHandler Depleted ;

public Battery():this(1.0 , 0.15)
{
//...
}

//新的构造函数
public Battery(double currentLevel , double mininumLevel)
{
_currentLevel = currentLevel ;

_mininumLevel = mininumLevel ;
}

/// <summary>
/// 该属性表示当前电量级别
/// </summary>
public double CurrentLevel
{
get
{
return _currentLevel ;
}
set
{
if ( value < 0.0 || value > 1.0 )
{
throw new ArgumentOutOfRangeException("value" , value , "CurrentLevel must be between 0.0 and 1.0 " ) ;
}

_currentLevel = value ;

if ( _currentLevel > DepletedLevel && _currentLevel < _mininumLevel )//处于低电量状态
{
LowChargeEventArgs e = new LowChargeEventArgs( _currentLevel ) ;

OnLowCharge( e ) ;//引发电量低的事件
}
else if ( _currentLevel > 0.0 && _currentLevel <= DepletedLevel )//处于电量耗尽状态
{
LowChargeEventArgs e = new LowChargeEventArgs( _currentLevel ) ;

OnDepleted( e ) ;//引发电量耗尽的事件
}
}
}

/// <summary>
/// 该属性表示允许使用的最小电量
/// </summary>
public double MininumLevel
{
get
{
return _mininumLevel ;
}
set
{
if ( value <= DepletedLevel || value > 0.5 )
{
throw new ArgumentOutOfRangeException("value" , value , string .Format("MininumLevel must be greater than {0:f2} and less than 0.5" , DepletedLevel ) ) ;
}
else
{
_mininumLevel = value ;
}
}
}

/// <summary>
/// 当前电量小于允许的最小电量时的事件处理程序
/// </summary>
/// <param name="e"></param>
public virtual void OnLowCharge( LowChargeEventArgs e )
{
if ( LowCharge != null )
{
LowCharge( this , e ) ;
}

}

/// <summary>
/// 电量耗尽时的事件处理程序
/// </summary>
/// <param name="e"></param>
public virtual void OnDepleted( LowChargeEventArgs e )
{
if ( Depleted != null )
{
Depleted( this ,e ) ;
}
}
}

4、LapTop.cs（膝上型电脑类，它使用了电池类Battery）

public class LapTop
{
private Battery _battery ;

public LapTop()
{
_battery = new Battery() ;

_battery.LowCharge += new LowChargeEventHandler( this._battery_LowCharge ) ;

_battery.Depleted += new EventHandler(_battery_Depleted);
}

private void _battery_LowCharge(object sender , LowChargeEventArgs e )
{
Console.WriteLine( "Battery is low , {0:f1} percent charged" , e.Level * 100.0 ) ;

Console.WriteLine( "Save your work !" ) ;
}

private void _battery_Depleted(object sender,EventArgs e )
{
Console.WriteLine( "Battery is out of juice!" ) ;

Console.WriteLine( "Power down in 30 seconds..." ) ;
}

public void start()
{
do
{
double NewLevel = _battery.CurrentLevel - 0.05 ;

if ( NewLevel < 0.0 )
{
_battery.CurrentLevel = 0.0 ;
}
else
{
_battery.CurrentLevel = NewLevel ;

Thread.Sleep( 50 ) ;
}
}
while(_battery.CurrentLevel > 0.0 );
}

}

5、Main.cs（Main程序）

class MyEvent
{
[STAThread]
static void Main(string[] args)
{
LapTop myLapTop = new LapTop() ;

myLapTop.start() ;

Console.WriteLine( "Press enter to exit..." ) ;

Console.ReadLine() ;
}
}

请注意在Battery类中的定义

//低电量所要引发的事件
public event LowChargeEventHandler LowCharge ;

//电量耗尽时所要引发的事件
public event EventHandler Depleted ;

我们直接把事件成员当作公共成员进行公开，这样做是不好的。我们可以定义两个方法分别用于执行客户对事件的订阅与取消，这里就不写了。