由浅入深理解C#中的事件

目录

本文较长,给大家提供了目录,可以直接看自己感兴趣的部分。

前言

有关事件的概念

示例

​   简单示例

​   标准 .NET 事件模式

​   使用泛型版本的标准 .NET 事件模式

​   补充

总结
参考

前言

前面介绍了C#中的委托,事件的很多部分都与委托类似。实际上,事件就像是专门用于某种特殊用途的简单委托,事件包含了一个私有的委托,如下图所示:

image-20240102160538415

有关事件的私有委托需要了解的重要事项如下:

1、事件提供了对它的私有控制委托的结构化访问。我们无法直接访问该委托。

2、事件中可用的操作比委托要少,对于事件我们只可以添加、删除或调用事件处理程序。

3、事件被触发时,它调用委托来依次调用调用列表中的方法。

有关事件的概念

发布者(Publisher):发布某个事件的类或结构,其他类可以在该事件发生时得到通知。

订阅者(Subscriber):注册并在事件发生时得到通知的类或结构。

事件处理程序(event handler):由订阅者注册到事件的方法,在发布者触发事件时执行。

触发(raise)事件:调用(invoke)或触发(fire)事件的术语。当事件触发时,所有注册到它的方法都会被依次调用。

示例

简单示例

现在我们先来看一下最最原始的事件示例。其结构如下所示:

image-20240103101447689

委托类型声明:事件和事件处理程序必须有共同的签名和返回类型,它们通过委托类型进行描述。

事件处理程序声明:订阅者类中会在事件触发时执行的方法声明。它们不一定有显示命名的方法,还可以是匿名方法或Lambda表达式。

事件声明:发布者类必须声明一个订阅者类可以注册的事件成员。当声明的事件为public时,称为发布了事件。

事件注册:订阅者必须订阅事件才能在它被触发时得到通知。

触发事件的代码:发布者类中”触发“事件并导致调用注册的所有事件处理程序的代码。

现在我们可以照着这个思路去写示例代码。

首先声明一个自定义的委托类型:

 public delegate void MyDelegate();

该委托类型没有参数也没有返回值。

然后再写一个发布者类:

   public class Publisher
   {
       public event MyDelegate MyEvent;
       public void DoCount()
       {
           for(int i = 0; i < 10; i++) 
           { 
               Task.Delay(3000).Wait();            
                   
               //确认有方法可以执行
               if(MyEvent != null)
               {
                    //触发事件
                    MyEvent();
                }
               
           }
       }
   }

事件声明:

 public event MyDelegate MyEvent;

事件声明在一个类中,它需要委托类型的名称,任何注册到事件的处理程序都必须与委托类型的签名和返回类型匹配。它声明为public,这样其他类和结构可以在它上面注册事件处理程序。不能使用对象创建表达式(new表达式)来创建它的对象。

一个常见的误解就是把事件认为是类型,事件其实不是类型,它和方法、属性一样是类或结构的成员。

由于事件是成员,所以我们不能在一段可执行的代码中声明事件,它必须声明在类或结构中,和其他成员一样。

事件成员被隐式自动初始化为null。

事件声明的图解如下所示:

image-20240103140544886

触发事件:

              //确认有方法可以执行
               if(MyEvent != null)
               {
                    //触发事件
                    MyEvent();
                }

也可以这样写:

              //确认有方法可以执行
               if(MyEvent != null)
               {
                    //触发事件
                    MyEvent().Invoke();
                }

这两者是等效的,MyEvent();直接调用事件的委托,MyEvent().Invoke()使用显式调用委托的 Invoke 方法。

现在再看看订阅者类:

  public class Subscriber
  {          
      public void EventHandler()
      {
          Console.WriteLine($"{DateTime.Now}执行了事件处理程序");
      }
  }

订阅者类中有一个EventHandler方法,与前面定义的委托类型的签名与返回值类型一致。

在看下主函数:

 static void Main(string[] args)
 {
   Publisher publisher = new Publisher();
   Subscriber subscriber = new Subscriber();
   
   //订阅事件
   publisher.MyEvent += subscriber.EventHandler;
   
   publisher.DoCount();
 }
 publisher.MyEvent += subscriber.EventHandler;

就是在订阅事件,对应上面结构图中的事件注册,将subscriber类的EventHandler方法注册到publisher类的MyEvent事件上。

也可以通过:

 publisher.MyEvent -= subscriber.EventHandler;

取消订阅事件。

运行结果如下所示:

image-20240103151109073

本示例全部代码如下所示:

 internal class Program
 {
     public delegate void MyDelegate();
     public class Publisher
     {
         public event MyDelegate MyEvent;
         public void DoCount()
         {
             for(int i = 0; i < 3; i++) 
             { 
                 Task.Delay(3000).Wait();
              
                 //确认有方法可以执行
                 if(MyEvent != null)
                 {
                     //触发事件
                     MyEvent();
                 }
                 
             }
         }
     }
     public class Subscriber
     {          
         public void EventHandler()
         {
             Console.WriteLine($"{DateTime.Now}执行了事件处理程序");
         }
     }
     static void Main(string[] args)
     {
       Publisher publisher = new Publisher();
       Subscriber subscriber = new Subscriber();
       
       //订阅事件
       publisher.MyEvent += subscriber.EventHandler;
       
       publisher.DoCount();
     }
 }

以上就根据上面的结构图写出了一个使用事件的示例,但是本示例还有需要改进的地方。

上面我们触发事件检查空值是这样写的:

                 //确认有方法可以执行
                 if(MyEvent != null)
                 {
                     //触发事件
                     MyEvent();
                 }

C# 6.0 引入了空条件操作符之后,现在也可以这样做空值检查:

 MyEvent?.Invoke();

同时也不是一上来就检查空值,而是先将MyEvent赋给第二个委托变量localDelegate:

 MyDelegate localDelegate = MyEvent;
 localDelegate?.Invoke();

这个简单的修改可确保在检查空值和发送通知之间,如果一个不同的线程移除了所有MyEvent订阅者,将不会引发NullReferenceException异常。

标准 .NET 事件模式

以上我们以一个简单的例子介绍了C#中的事件,但是大家可能会觉得有点模式,跟我们平常在winform中使用的事件好像不太一样,那是因为 .NET 框架提供了一个标准模式,接下来我将以winform中的button按钮点击事件为例进行介绍。

页面很简单,只有一个button按钮:

image-20240104093125527

然后button按钮点击事件的代码如下:

 private void button1_Click(object sender, EventArgs e)
 {
     MessageBox.Show("Hello World");
 }

现在我们再根据下面这张事件结构图,来看一看标准的 .NET 事件模式:

image-20240103101447689

事件注册

打开解决方案中的Form1.Designer.cs文件:

image-20240104093502598

看到button1相关内容:

image-20240104093620010

button1.Click += button1_Click;

就是在订阅事件,对应上面图中的事件注册。

委托类型声明

右键查看定义:

 public event EventHandler? Click
 {
     add => Events.AddHandler(s_clickEvent, value);
     remove => Events.RemoveHandler(s_clickEvent, value);
 }

发现Click事件中的委托类型是EventHandler,再查看EventHandler的定义:

 public delegate void EventHandler(object? sender, EventArgs e);

这一步对应上面事件结构图中的委托类型声明。

EventHandler是 .NET中预定义的委托,专门用来表示不生成数据的事件的事件处理程序方法应有的签名与返回类型。

第一个参数是sender,用来保存触发事件的对象的引用。由于是object?类型,所以可以匹配任何类型的实例。

第二个参数是e,用于传递数据。但是EventArgs类表示包含事件数据的类的基类,并提供用于不包含事件数据的事件的值。也就是说EventArgs设计为不能传递任何数据。它用于不需要传递数据的事件处理程序,通常会被忽略。如果我们想要传递数据,必须声明一个派生自EventArgs的类,使用合适的字段来保存需要传递的数据。

尽管EventArgs类实际上并不传递数据,但它是使用EventHandler委托模式的重要部分。不管参数使用的实际类型是什么,object类和EventArgs类总是基类,这样EventHandler就能提供一个对所有事件和事件处理器都通用的签名,只允许两个参数,而不是各自都有不同签名。

事件声明
 public event EventHandler? Click
 {
     add => Events.AddHandler(s_clickEvent, value);
     remove => Events.RemoveHandler(s_clickEvent, value);
 }

Click事件在Control类中定义,Button类继承自ButtonBase类,而ButtonBase类继承自Control类。

public event EventHandler? Click;

对应上面结构图中的事件声明。

触发事件的代码

查看Button类的定义,找到OnClick方法的定义:

 protected override void OnClick(EventArgs e)
 {
     Form? form = FindForm();
     if (form is not null)
     {
         form.DialogResult = _dialogResult;
     }

     // accessibility stuff
     AccessibilityNotifyClients(AccessibleEvents.StateChange, -1);
     AccessibilityNotifyClients(AccessibleEvents.NameChange, -1);

     // UIA events:
     if (IsAccessibilityObjectCreated)
     {
         AccessibilityObject.RaiseAutomationPropertyChangedEvent(UiaCore.UIA.NamePropertyId, Name, Name);
         AccessibilityObject.RaiseAutomationEvent(UiaCore.UIA.AutomationPropertyChangedEventId);
     }

     base.OnClick(e);
 }

去掉无关部分,保留相关部分便于理解:

 protected override void OnClick(EventArgs e)
 {
         base.OnClick(e);
}    

这里的base指的是Button类的基类ButtonBase类:

image-20240104103143021

再查看ButtonBase类中OnClick方法的定义:

 protected override void OnClick(EventArgs e)
 {
     base.OnClick(e);
     OnRequestCommandExecute(e);
 }

发现也有一个base.OnClick(e);,这里的base指的是ButtonBase类的基类Control

image-20240104103450257

再查看Control类中OnClick方法的定义:

 /// <summary>
 ///  Raises the <see cref="Click"/>
 ///  event.
 /// </summary>
 [EditorBrowsable(EditorBrowsableState.Advanced)]
 protected virtual void OnClick(EventArgs e)
 {
     ((EventHandler?)Events[s_clickEvent])?.Invoke(this, e);
 }

终于找到了触发事件的代码。

事件处理程序

这个想必大家并不陌生,双击button按钮就可以看到:

  private void button1_Click(object sender, EventArgs e)
  {
      MessageBox.Show("Hello World");
  }

这对应上面结构图中的事件处理程序。该事件处理程序方法的签名与返回值类型与EventHandler委托类型一致。

使用泛型版本的标准 .NET事件模式

接下来我会举一个例子,说明如何使用泛型版本的标准 .NET事件模式。

第一步,自定义事件数据类,该类继承自EventArgs类:

  public class MyEventArgs : EventArgs
  {
      public string? Message {  get; set; }
      public DateTime? Date {  get; set; }
  }

拥有两个属性Message与Date。

第二步,写发布者类:

  public class Publisher
  {
      public event EventHandler<MyEventArgs>? SendMessageEvent;
      public void SendMessage()
      {
          for(int i = 0; i < 3; i++)
          {
              Task.Delay(3000).Wait();
              MyEventArgs e = new MyEventArgs();
              e.Message = $"第{i+1}次触发事件";
              e.Date = DateTime.Now;
              EventHandler<MyEventArgs>? localEventHandler = SendMessageEvent;
              localEventHandler?.Invoke(this, e);
          }
      }
  }
public event EventHandler<MyEventArgs>? SendMessageEvent;

声明了事件。

 EventHandler<MyEventArgs>? localEventHandler = SendMessageEvent;
 localEventHandler?.Invoke(this, e);

触发了事件。

第三步,写订阅者类:

 public class Subscriber
 {
     public void EventHandler(object? sender,MyEventArgs e)
     {
         Console.WriteLine($"Received Message:{e.Message} at {e.Date}");
     }
 }

包含事件处理程序,该方法与EventHandler<MyEventArgs>委托类型的签名与返回值类型一致。

第四步,写主函数:

  static void Main(string[] args)
  {
     Publisher publisher = new Publisher();
     Subscriber subscriber = new Subscriber();
     publisher.SendMessageEvent += subscriber.EventHandler;
     publisher.SendMessage();
  }
 publisher.SendMessageEvent += subscriber.EventHandler;

订阅事件。

运行结果如下所示:

image-20240104115222746

包含了我们自定义的事件数据。

补充

上面说自定义的事件数据类要继承自EventArgs类,但其实在 .NET Core 的模式较为宽松。 在此版本中,EventHandler<TEventArgs> 定义不再要求 TEventArgs 必须是派生自 System.EventArgs 的类。

因此我在.NET 8 版本的示例中去掉继承自EventArgs类,该示例依旧能正常运行。

异步事件订阅者

一个关于异步事件订阅者的例子如下:

// 事件发布者
public class EventPublisher
{
    // 定义异步事件
    public event Func<string, Task>? MyEvent;

    // 触发事件的方法
    public async Task RaiseEventAsync(string message)
    {
        Func<string, Task> localEvent = MyEvent;
        await localEvent?.Invoke(message);
    }
}

// 异步事件订阅者
public class AsyncEventSubscriber
{
    // 处理事件的异步方法
    public async Task HandleEventAsync(string message)
    {
        Console.WriteLine($"Received event with message: {message}");

        // 异步操作,例如IO操作、网络请求等
        await Task.Delay(3000);

        Console.WriteLine("Event handling complete.");
    }
}

class Program
{
    static async Task Main(string[] args)
    {
        // 创建事件发布者
        var publisher = new EventPublisher();

        // 创建异步事件订阅者
        var subscriber = new AsyncEventSubscriber();

        // 订阅事件
        publisher.MyEvent += subscriber.HandleEventAsync;

        // 触发事件
        await publisher.RaiseEventAsync("Hello, world!");

        Console.ReadLine();
    }
}

运行结果如下所示:

image-20240104123351663

总结

本文先是介绍了一些C#中事件的相关概念,然后通过几个例子介绍了在C#中如何使用事件。

参考

1、《C#图解教程》

2、《C# 7.0 本质论》

3、[C# 文档 - 入门、教程、参考。 | Microsoft Learn](

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/294589.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

sqlserver工具插入表语法into新表问题

文章目录 sqlserver工具插入表语法into新表问题 sqlserver工具插入表语法into新表问题 into新表问题 SELECT 1 AS FID, AS FNUMBER,1 AS FVALUE,A AS FVALUE2,名字 AS FNAME, 你的全名 FFULLNAME INTO t_user_mmINSERT INTO t_user_mm VALUES(2,2,2,B,懒人,懒人咖)INSERT I…

FreeRTOS——内存管理知识总结及实战

1 freeRTOS动态创建与静态创建 动态创建&#xff1a;从FreeRTOS 管理的内存堆中申请创建对象所需的内存&#xff0c;在对象删除后&#xff0c; 这块内存释放回FreeRTOS管理的内存堆中 静态创建&#xff1a;需用户提供各种内存空间&#xff0c;并且使用静态方式占用的内存空间一…

VCoder:大语言模型的眼睛

简介 VCoder的一个视觉编码器&#xff0c;能够帮助MLLM更好地理解和分析图像内容。提高模型在识别图像中的对象、理解图像场景方面的能力。它可以帮助模型显示图片中不同物体的轮廓或深度图&#xff08;显示物体距离相机的远近&#xff09;。还能更准确的理解图片中的物体是什…

(Java基础知识综合)

进制转换&#xff1a; 其他转10 10转其他 2进制8和16 8和16转2 位运算&#xff1a; >> 除于2 <<乘以2 近似值 空心金字塔 this关键字还可以用于访问父类中的属性和方法

axios 二次封装 设置token

// 公有 axios.defaults.headers.common[Y-Auth-Token]eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c 设置后 并发起请求&#xff0c;你可以在浏览器控制台…

电脑提示“KBDRU1.DLL文件缺失”,导致游戏和软件无法启动运行,快速修复方法

看到很多小伙伴&#xff0c;在问电脑启动某些软件或游戏的时候&#xff0c;提示“KBDRU1.DLL文件缺失&#xff0c;软件无法启动&#xff0c;请尝试重新安装&#xff0c;解决问题”&#xff0c;不知道应该怎么办&#xff1f; 首先&#xff0c;我们要先了解“KBDRU1.DLL文件”是什…

数据结构学习 jz16 数值的整数次方

关键词&#xff1a;快速幂 位运算 之前已经学过快速幂了&#xff0c;所以只是回忆。快速幂有递归版和非递归版。 题目&#xff1a; 这道题和之前的快速幂的区别是 n可能为负数。分类讨论即可。 思路&#xff1a; 区分正负&#xff1a; if (n < 0) return POW(1.0 / x, …

ASUS华硕ROG幻14笔记本2023款G14 GA402XV原装出厂Win11系统

华硕幻14锐龙R9-7940HS笔记本电脑原厂Windows11.22H2系统 适用型号&#xff1a;GA402XU、GA402XV、GA402XI、GA402XY、GA402XZ 链接&#xff1a;https://pan.baidu.com/s/1sMva1u7D8uFoGnm2Hjrdug?pwdho91 提取码&#xff1a;ho91 原厂系统自带所有驱动、出厂主题壁纸、…

AWS EKS1.26+kubesphere3.4.1

1、前提准备 1台EC2服务器Amazon Linux2&#xff0c;设置admin的角色 安装 aws cli V2 ​ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"unzip awscliv2.zipsudo ./aws/installexport PATH/usr/local/bin:$PATHsou…

pod进阶版(2)

startupProbe启动探针 如果探测失败,pod的状态是notready&#xff0c;启动探针会重启容器 启动探针没有成功之前&#xff0c;后续的探针都不会执行。启动探针成功之后&#xff0c;在pod的后续生命周期不会用启动探针 exec方式 正确示范 apiVersion: v1 kind: Pod metadata…

【React系列】react-router

本文来自#React系列教程&#xff1a;https://mp.weixin.qq.com/mp/appmsgalbum?__bizMzg5MDAzNzkwNA&actiongetalbum&album_id1566025152667107329) 一. 认识react-router 1.2. 前端路由原理 前端路由是如何做到URL和内容进行映射呢&#xff1f;监听URL的改变。 UR…

【优选算法】专题三:二分查找 --- 34. 在排序数组中查找元素的第一个和最后一个位置

从今天开始,xxxflower 带着小伙伴们一起学习算法 ~ 今天我们要写的题目是: 34. 在排序数组中查找元素的第一个和最后一个位置 以下是题目的详细解析: class Solution {public int[] searchRange(int[] nums, int target) {// 判断数组为空的情况下返回-1,-1int[] ret new in…

在centos上安装WordPress 及创建配置文件无反应的解决方案

一、安装Apache服务 1.直接在命令行中输入以下命令即可,顺便安装编译组件&#xff1a; yum install -y httpd yum install -y httpd-devel2.启动Apache服务和设置Apache自启&#xff1a; 1 systemctl start httpd 2 systemctl enable httpd 3.添加一个测试页面&#xff0c;…

4《数据结构》

文章目录 绪论逻辑结构存储结构【物理结构】顺序和链式存储区别顺序表和数组区别数组和链表的区别链表结点概念链表为空条件链表文章http://t.csdnimg.cn/dssVK二叉树B树B树【MYSQL索引默认数据结构】B树和B树区别冒泡排序插排选排快排 绪论 数据结构&#xff1a;研究非数值计…

Html5实用个人博客留言板模板源码

文章目录 1.设计来源1.1 主界面1.2 认识我界面1.3 我的日记界面1.4 我的文章列表界面和文章内容界面1.5 我的留言板界面 2.演示效果和结构及源码2.1 效果演示2.2 目录结构2.3 源代码 源码下载 作者&#xff1a;xcLeigh 文章地址&#xff1a;https://blog.csdn.net/weixin_43151…

关于MySQL Cluster

目录 1.MySQL Cluster2.MySQL Cluster架构3.MySQL Cluster 与 MySQL 主从架构有什么区别4.参考 MySQL Cluster是MySQL的一个高可用性&#xff0c;高性能的分布式数据库解决方案。它结合了内存数据库和共享无状态架构的技术&#xff0c;提供了99.999%的可用性&#xff0c;满足严…

经典目标检测YOLO系列(一)YOLOV1的复现(1)总体架构

经典目标检测YOLO系列(一)实现YOLOV1网络(1)总体架构 实现原版的YOLOv1并没有多大的意义&#xff0c;因此&#xff0c;根据《YOLO目标检测》(ISBN:9787115627094)一书&#xff0c;在不脱离YOLOv1的大部分核心理念的前提下&#xff0c;重构一款较新的YOLOv1检测器&#xff0c;来…

【EI会议征稿通知】第十届先进制造技术与应用材料国际学术会议(ICAMMT 2024)

第十届先进制造技术与应用材料国际学术会议&#xff08;ICAMMT 2024&#xff09; The 10th International Conference on Applied Materials and Manufacturing Technology 至今ICAMMT已连续举办九届&#xff0c;会议先后在三亚、杭州、清远等城市成功召开。每一届最终征集收…

K8S--部署SpringBoot项目实战

原文网址&#xff1a;K8S--部署SpringBoot项目实战-CSDN博客 简介 本文介绍K8S如何部署SpringBoot项目。 1.生成应用的docker镜像 把SpringBoot项目的jar包打包为docker镜像&#xff0c;见&#xff1a;Docker Compose--部署SpringBoot项目--实战-CSDN博客 创建后的镜像名称…

Django和Vue项目运行过程中遇到的问题及解决办法

这是我从CSDN上边买来的一个系统的资源&#xff0c;准备在此基础上改成自己的系统&#xff0c;但是在运行项目这一步上都把自己难为了好几天&#xff0c;经过不断的摸索&#xff0c;终于完成了第一步&#xff01;&#xff01;&#xff01; 如果大家也遇到同样的问题&#xff0…