C#学习笔记（三十五）-- 定义事件

        现在论述如何定义和使用自己的事件。我们将使用处理事件中介绍的即时消息传送应用程序示例，并创建一个Connection对象，该对象引发由Display对象处理的事件。

        1)在处理事件的源程序的同目录下，创建一个新的控制台应用程序Ch13Ex02

        2）添加一个新类Connection，并修改Connection.cs，如下所示：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Timers;
using static System.Console;
namespace Ch13Ex02
{
   public delegate void MessageHandler(string messageText);
   public class Connection
   {
      public event MessageHandler MessageArrived;
      private Timer pollTimer;
      public Connection()
      {
         pollTimer = new timer(100);
         pollTimer.Elapsed += new ElapsedEventHandler(CheckForMessage);
      }
      public void Connect() => pollTimer.Start();
      public void Disconnect() => pollTimer.Stop();
      private static Random random = new Random();
      private void CheckForMessage(object source,ElapsedEventArgs e)
      {
         WriteLine("Checking for new messages.");
         if ((random.Next(9) == 0) && (MessageArrived != null))
         {
            MessageArrived("Hello Donna!");
         }
      }
   }
}

        3）添加一个新类Display，并修改Display.cs，如下所示：

using static System.Console;
namespace Ch13Ex02
{
    public class Display
    {
        public void DisplayMessage(String message) => WriteLine($"Message arrived: (message)");
    }
}

        4）修改Program.cs中的代码，如下所示：

static void Main(string[] args)
{
    Connection myConnection = new Connection();
    Display myDisplay = new Display();
    myConnection.MessageArrived += new MessageHandler (myDisplay.DisplayMessage);
    myConnection.Connect();
    Readkey();
}

        5）示例说明：

        这个应用程序中的大部分工作是由Connection类完成的。这个类的实例使用如使用事件中所示的Timer对象，在类的构造函数中初始化它，并通过Connect()和Disconnect()访问它的状态（可访问和禁止访问）：

public class Connection
{
    private Timer pollTimer;
    public Connection()
    {
        pollTimer = new Timer(100);
        pollTimer.Elapsed += new ElapsedEventHandler(CheckForMessage);
    }
    public void Connect() => pollTimer.Start();
    public void Disconnect() => pollTimer.Stop();
    ...
}

        在构造函数中，我们还以与第一个示例相同的方式注册了Elapsed事件的一个事件处理程序。当调用这个处理程序方法CheckForMessage()次数达到10次后，就会引发一个事件。在分析其代码之前，首先分析事件的定义。

        在定义事件前，必须首先定义一个委托类型，以用于该事件，这个委托类型指定了事件处理方法必须拥有的返回类型和参数。为此，我们使用标准的委托语法，在Ch13Ex02名称空间中将该委托定义为公共类型，是该类型可供外部代码使用：

namespace Ch13Ex02
{
    public delegate void MessageHandler(string messageText);

        这个委托类型称为MessageHandler，是void方法的签名，它有一个string参数。使用这个参数可以把Connection对象收到的即时消息发送给Display对象。定义了委托（或者找到合适的现有委托）后，就可以把事件本身定义为Connection类的一个成员。

public class Connection
{
    public event MessageHandler MessageArrived;

        给事件命名（这里使用名称MessageArrived），在声明时，使用event关键字，并指定要使用的委托类型（前面定义的MessageHandler委托类型）。以这种方式声明事件后，就可以引发它，做法是按名称来调用它，就像它是一个返回类型和参数是由委托指定的方法一样。例如，可以使用下面的代码引发这个事件：

MessageArrived("This is a message.");

        如果定义该委托时不包含任何参数，就可以使用下面的代码：

MessageArrived();

        如果定义了较多参数，就需要用比较多的代码来引发事件。CheckForMessage()方法如下所示：

private static Random random = new Random();
private void CheckForMessage(object source, ElapasedEventArgs e)
{
    WriteLine("Checking for new message.");
    if ((random.Next(9) == 0) && (MessageArrived != null))
    {
        MessageArrived("Hello Mami!");
    }
}

        使用Random类的实例，生成一个介于0~9之间的随机数，如果该随机数为0，就引发一个事件，它的发生概率为10%。这类似与轮询连接，看看是否接受到消息，不可能每次检测时，都没有接收到消息。为将计时器与Connection的实例分隔开，使用了Random类的一个私有静态实例。

        注意，这里还提供了其他逻辑。只有表达式MessageArrived != null为true时，才引发一个事件。这个表达式也使用了委托语法，但语法稍有不同，其含义是“事件是否有订阅者？”。如果没有订阅者，MessageArrived就是null，也就不会引发事件。

        订阅事件的类是Display，它包含一个方法DisplayMessage()，其定义如下所示：

public class Display
{
    public void DisplayMessage(string message) => WriteLine($"Message arrived:{message}");
}

        这个方法匹配委托类型（而且是公共的，如果类不是生成该事件的类，则其事件处理程序必须是公共的），所以可以用它来响应MessageArrived事件。

        Main()中的代码初始化了Connection和Display类的实例，把他们关联起来，开始执行任务。这里需要的代码类似于第一个示例中的代码：

static void Main(string[] args)
{
    Connection myConnection = new Connection();
    Display myDisplay = new Display();
    myConnection.MessageArrived += new MessageHandler(myDisplay.DisplayMessage);
    myConnection.Connect();
    System.Threading.Thread.Sleep(200);
    readKey();
}

        再次调用ReadKey()，当开始执行Connection对象的Connect()方法并增加一段延迟事件后，暂停Main()的处理