Стандартный блок: обработка событий
Дата последнего изменения: 7 апреля 2010 г.
Применимо к: SharePoint Foundation 2010
Основные объекты в объектной модели SharePoint Foundation предоставляют базовые классы приемников событий, которые можно использовать при написании обработчиков событий. Например, объект SPWeb содержит соответствующий тип SPWebEventReceiver, в объекте SPList есть тип SPListEventReceiver и т. д. Типы приемника события не реализуются непосредственно, вместо этого нужно создать класс с наследованием от соответствующего класса приемника и реализовать производный класс. Учтите, что все классы приемников событий SharePoint наследуются от одного базового класса приемник события, а именно SPEventReceiverBase.
После написания приемники событий SharePoint Foundation компилируются в сборки приемников событий и развертываются в кэше глобальных сборок (GAC). Приемники событий также должны быть зарегистрированы в области, в которой они обрабатывают события.
Объектная модель событий
Нет такого пространства имен обработчика событий, в котором размещены типы обработчиков. Обработчики событий расположены в том же пространстве имен, что и связанные объекты SharePoint. Например, все объекты верхнего уровня SharePoint (SPWeb, SPSite, SPList и другие) размещены в пространстве имен Microsoft.SharePoint вместе со связанными типами приемников событий. Обратите внимание, что соглашение об именовании типов приемников событий соответствует шаблону, описанному выше, а именно <имя_объекта> с термином "EventReceiver" в качестве суффикса. Таким образом типы приемников событий наподобие SPWorkflowEventReceiver и StyleLibraryEventReceiver легко определить и понять.
.gif "Предупреждающая заметка") Внимание! |
|---|
Из правила именования приемников событий есть некоторые исключения. Например, имя приемника события для компонентов SharePoint — SPFeatureReceiver, а не SPFeatureEventReceiver, как можно было ожидать. |
Типы приемников событий также связаны с контейнерами свойств события, которые предоставляют доступ к различным свойствам определенного события. Контейнеры свойств события обычно именуются как <имя_объекта> и добавленным суффиксом "EventProperties". К типичным контейнерам свойств события относятся SPWebEventProperties, SPListEventProperties и другие.