VB.NET开发Viewer Form时按钮点击事件方法创建报错如何解决

核心原因 #

WinForm 窗体的控件事件不是通过方法名大小写匹配自动关联的，双击设计器控件不生成事件，本质是设计器缓存异常或控件绑定关系断裂；手动编写方法报错，基本是因为缺少事件绑定关联，和方法名里的控件名大小写无关。

分步排查修复 #

1. 修复设计器自动生成事件失效问题 #

• 关闭所有打开的代码编辑页、窗体设计器页，右键单击项目选择「清理」，清理完成后执行「重新生成项目」，重新打开窗体设计器，双击目标按钮测试是否能自动生成绑定完成的事件方法。
• 上述操作无效时，选中窗体上的Select Picture按钮，打开属性窗口，点击窗口顶部的闪电形「事件」图标，在事件列表中找到Click条目，双击条目后方的空白区域，设计器会自动生成正确绑定的事件方法，无需手动编写方法声明。

2. 修复手动编写事件方法的报错 #

你之前修改方法名里btn/Btn大小写无法解决问题，核心是缺少事件和控件的绑定，两种修复方式选其一即可：

• 推荐方式（无代码修改）：在上述属性窗口的Click事件下拉列表中，直接选中你已经手动编写的方法名，设计器会自动完成绑定，不需要修改任何代码。
• 手动补全绑定方式：打开窗体代码文件，在你编写的点击事件方法声明末尾，添加和控件实际名称匹配的Handles子句，参考示例：

' 注意Handles后面的控件名必须和按钮的Name属性完全一致（大小写完全匹配）
Private Sub btnSelectPicture_Click(sender As Object, e As EventArgs) Handles btnSelectPicture.Click
    ' 选择图片功能逻辑示例
    Dim pickImageDlg As New OpenFileDialog With {
        .Filter = "图片文件|*.jpg;*.jpeg;*.png;*.bmp;*.gif"
    }
    If pickImageDlg.ShowDialog() = DialogResult.OK Then
        PictureBox1.Image = Image.FromFile(pickImageDlg.FileName)
    End If
End Sub

3. 仍存在异常时的深度排查 #

• 打开窗体对应的[窗体名].Designer.vb设计器代码文件，检查是否存在目标按钮的声明代码，正确的声明格式为Friend WithEvents 按钮Name属性值 As Button，如果缺失该行，设计器无法识别控件，自然无法生成对应事件，直接从设计器工具箱重新拖一个按钮替换即可，无需手动修复设计器代码。
• 检查手动编写的事件方法参数签名，Click事件要求参数必须为(sender As Object, e As EventArgs)，参数缺失、类型写错都会触发签名不匹配报错。
• 如果设计器文件出现不可逆损坏，直接删除原有问题按钮，从工具箱重新拖入新按钮，配置相同的文本、位置、大小属性后，双击新按钮即可正常生成事件。

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