如何在VB.NET项目中自动检测缺失的Handles子句

1 内置静态代码分析配置 #

• 打开VB项目属性页，进入「代码分析」选项卡，启用所有VB专属代码分析规则。找到对应「未关联事件的事件处理程序」的VB规则，将其严重等级调整为「错误」。编译时会自动识别符合事件处理签名、既无Handles绑定也未被AddHandler引用的方法，直接阻断编译，从流程上避免问题代码进入发布环节。
• 如果默认规则无法覆盖自定义事件场景，可基于Roslyn编写轻量自定义分析器，匹配项目内约定的处理程序命名规则（如[控件名]_[事件名]的命名规则），检测到对应方法未绑定事件则直接报错。

2 正则表达式批量检测实现 #

你可以使用以下自定义正则，在VS全局搜索或CI流程中批量匹配缺失Handles的事件处理程序：

^\s*(Private|Protected|Friend|Public)\s+Sub\s+[a-zA-Z0-9_]+_(Click|Load|TextChanged|SelectedIndexChanged|ValueChanged|你的自定义事件名列表)\s*\([^)]*\)\s*(?!Handles)

• 正则说明：会匹配所有符合你项目命名约定的事件处理子程序，且行末未紧跟Handles关键字的代码行。你可以根据项目实际使用的事件名，扩充正则内的事件名列表，提升匹配准确率。
• 你可以将该正则加入VS「在文件中查找」的保存搜索项，每次提交代码前全解决方案扫描一次，数秒内即可定位所有潜在问题。
• 还可以将该检测逻辑封装为SVN的pre-commit钩子，代码提交时自动扫描，存在匹配项则直接拦截提交，强制开发人员确认修正。

3 过渡期补充保障方案 #

• 编写轻量单元测试：通过反射遍历项目中所有窗体、用户控件类的方法，筛选符合事件处理签名的方法，再校验对应控件是否绑定了对应事件，单元测试不通过则无法合并代码，实现全量自动化校验。
• 对已经完成AddHandler手动绑定改造的方法，可添加自定义标记Attribute（如<ManualEventBinding>），检测逻辑碰到带该标记的方法直接跳过Handles校验，避免误报。

内容的提问来源于stack exchange，提问作者Johannes Reiser