/***********************************************************************************
Doer: Himage
Date: 2004-10-22
Time: 12:59
Goal:
这是学习事件时候写的一个简单的例子，以加深对对事件的理解。此程序参照了.Net文档中的
闹钟例子。
Note:
1.这个例子模拟这样一个情形：
当主人肚子饿的时候，他会引发一个吃饭事件， 并说明一些与吃饭有关的数据（如：地点）
这个事件由他的仆人来处理（告诉主人食物已经准备好了）。但主人由哪个仆人伺候呢？并且
主人什么时候肚子饿呢？ 这就由上帝来安排了。比如说，上帝安排秦始皇的仆人是李斯，在
中午12点的时候，上帝会叫这个主人肚子饿。
2.实现此例子的主要元素：
类EatEventArgs－－封装与吃饭事件有关的一些数据；
委托EatEventHandler－－处理吃饭这个事件的模式(类似c++中的函数指针)；
类Master－－这个类将引发吃饭事件(EatEvent);
类Servant－－这个类拥有处理吃饭事件的方法，此方法满足委托EatEventHandler模式。
3.为了将注意力放在事件的学习上，我将类的一些数据域(field)设为公有(public)。
4.在源代码中加上必要和详细的注释是个好习惯。
************************************************************************************/
using System;
namespace nsEventSample
{
/// <summary>
/// 类EatEventArgs 必须继承自类EventArgs，用来引发事件时封装数据
/// </summary>
public class EatEventArgs : EventArgs
{
public String restrauntName; //饭店名称
public decimal moneyOut; //准备消费金额
}
/// <summary>
/// 这个委托用来说明处理吃饭事件的方法的方法头(模式)
/// </summary>
public delegate void EatEventHandler(object sender, EatEventArgs e);
/// <summary>
/// 引发吃饭事件(EateEvent)的类Master(主人)，这个类必须
/// 1.声明一个名为EatEvent的事件: public event EatEventHandler EatEvent;
/// 2.通过一个名为OnEatEvent的方法来引发吃饭事件，给那些处理此事件的方法传数据；
/// 3.说明在某种情形下引发事件呢？在饿的时候。用方法Hungrg来模拟。
/// </summary>
public class Master
{
//声明事件
public event EatEventHandler EatEvent;
//引发事件的方法
public void OnEatEvent(EatEventArgs e)
{
if (EatEvent != null)
{
EatEvent(this, e);
}
}
//当主人饿的时候，他会指定吃饭地点和消费金额。
public void Hungry(String restrauntName, decimal moneyOut)
{
EatEventArgs e = new EatEventArgs();
e.restrauntName = restrauntName;
e.moneyOut = moneyOut;
Console.WriteLine("主人说：");
Console.WriteLine("我饿了，要去{0}吃饭，消费{1}元", e.restrauntName, e.moneyOut);
//引发事件
OnEatEvent(e);
}
}
/// <summary>
/// 类Servant(仆人)有一个方法ArrangeFood(安排食物)来处理主人的吃饭事件
/// </summary>
public class Servant
{
public void ArrangeFood(object sender, EatEventArgs e)
{
Console.WriteLine();
Console.WriteLine("仆人说:");
Console.WriteLine("我的主人, 您的命令是 : ");
Console.WriteLine("吃饭地点 -- {0}", e.restrauntName);
Console.WriteLine("准备消费 -- {0}元 ", e.moneyOut);
Console.WriteLine("好的，正给您安排。。。。。。。。");
Console.WriteLine("主人，您的食物在这儿，请慢用");
}
}
/// <summary>
/// 类God安排qinshihuang（秦始皇）的仆人是lisi（李斯），并让李斯的ArrangeFood
/// 方法来处理qinshihuang的吃饭事件：qinshihuang.EatEvent += new EatEventHandler(lishi.ArrangeFood);
/// </summary>
public class God
{
public static void Main()
{
Master qinshihuang = new Master();
Servant lishi = new Servant();
qinshihuang.EatEvent += new EatEventHandler(lishi.ArrangeFood);
//秦始皇饿了，想去希尔顿大酒店，消费5000元
qinshihuang.Hungry("希尔顿大酒店", 5000.0m);
}
}
}
/***********************************************************************************
程序结果:
主人说：
我饿了，要去希尔顿大酒店吃饭，消费5000.0元
仆人说:
我的主人, 您的命令是 :
吃饭地点 -- 希尔顿大酒店
准备消费 -- 5000.0元
好的，正给您安排。。。。。。。。
主人，您的食物在这儿，请慢用
************************************************************************************/
