Соглашение об именах для обработчиков событий элементов управления всегда было controlName_EventName
, поэтому в основном оно использует ваше собственное соглашение об именах для элемента управления, а затем подбирает имя события.
Это может противоречить общему стандарту именования, но так было всегда.
Результатом этого является то, что такие инструменты, как GhostDoc , могут распознавать этот формат и, таким образом, генерировать документацию, которая, хотя и является универсальной, имеет большее значение, чем если бы она пыталась определить цель самого метода.
Например, метод «controlName_EventName» может быть задокументирован так:
/// <summary>
/// Handles the EventName event of the controlName control.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The <see cref="System.EventArgs"/> instance
/// containing the event data.</param>
protected void controlName_EventName(object sender, EventArgs e)
{
вместо того, чтобы вот так: (поскольку GhostDoc обрабатывает все вышеперечисленное, я здесь занимаюсь рекламой, основываясь на опыте с неправильными именами методов):
/// <summary>
/// Control names the event name.
/// </summary>
/// <param name="sender">The sender.</param>
/// <param name="e">The e.</param>
protected void controlName_EventName(object sender, EventArgs e)
{