Control.Events Control.Events Control.Events Control.Events Property

Определение

Возвращает список делегатов обработчиков событий элемента управления.Gets a list of event handler delegates for the control. Это свойство доступно только для чтения.This property is read-only.

protected:
 property System::ComponentModel::EventHandlerList ^ Events { System::ComponentModel::EventHandlerList ^ get(); };
protected System.ComponentModel.EventHandlerList Events { get; }
member this.Events : System.ComponentModel.EventHandlerList
Protected ReadOnly Property Events As EventHandlerList

Значение свойства

Список делегатов обработчиков событий.The list of event handler delegates.

Примеры

В следующем примере создается событие с именем Click, которое добавляет и удаляет обработчики из EventHandlerList коллекции элемента управления, когда событие вызывается из страницы.The following example creates an event, named Click, that adds and removes handlers from the control's EventHandlerList collection when the event is called from a page.

Примечание . В этом примере выполняется оптимизация того, как элемент управления добавляет и удаляет события из списка, который поддерживает элемент управления.Note This example optimizes how a control adds and removes events from the list of them that the control maintains. Если вы создаете пользовательский элемент управления и хотите определить событие, используйте код, аналогичный этому.If you create custom control and want to define an event, use code similar to this. Этот метод можно использовать в C#, но не в Visual Basic.This technique can be used in C#, but not in Visual Basic.

// Create an event that adds and removes handlers from the
// Control.Events collection when this event is called from
// a participating page.
public event EventHandler Click {
    add {
        Events.AddHandler(EventClick, value);
    }
    remove {
        Events.RemoveHandler(EventClick, value);
    }
}

Комментарии

Это свойство имеет тип EventHandlerList, который использует алгоритм линейного поиска для поиска записей в списке делегатов.This property is of type EventHandlerList, which uses a linear search algorithm to find entries in the list of delegates. Линейный алгоритм поиска неэффективен при работе с большим количеством записей.A linear search algorithm is inefficient when working with a large number of entries. Таким образом, если имеется большой список, Поиск записей с этим свойством будет выполняться очень долго.Therefore, when you have a large list, finding entries with this property will be slow.

Применяется к

Дополнительно