编写高质量代码改善C#程序的157个建议——建议139:事件处理器命名采用组合方式
建议139:事件处理器命名采用组合方式
所谓事件处理器,就是实际被委托执行的那个方法。查看如下代码:
public MainWindow() { InitializeComponent(); Button button = new Button(); button.Click += button_Click; button.SizeChanged += button_SizeChanged; button.MouseDown += button_MouseDown; } void button_Click(object sender, EventArgs e) { throw new NotImplementedException(); } void button_SizeChanged(object sender, EventArgs e) { throw new NotImplementedException(); } void button_MouseDown(object sender, MouseEventArgs e) { throw new NotImplementedException(); }
这段代码中,方法button_Click、button_SizeChanged、button_MouseDown即称作事件处理器。VS默认为我们生成的事件处理器的命名规则:
事件变量所属对象+下划线+事件变量名
这种命名的方法用于注册的方法(即“+=”操作符)添加事件处理器。如果我们要为委托或委托中的回调编写处理器,则应该使用如下命名规则:
委托变量所属对象+On+委托变量名
如下:
public bool NameOnValidateValue(object value) { } public void NameOnPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) { }
失败的命名:
public void NameChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) { }
这个命名看上去更应该是一个委托或者事件变量。
当然,如果处理器在类内部,则可以忽略掉前面所属类型,直接以On作为前缀。
转自:《编写高质量代码改善C#程序的157个建议》陆敏技