构造块:事件处理

上次修改时间: 2010年4月7日

适用范围: SharePoint Foundation 2010

SharePoint Foundation 对象模型中的主对象提供在编写事件处理程序时从中派生的事件接收器基类。例如,SPWeb 对象具有相应的 SPWebEventReceiver 类型,SPList 对象具有 SPListEventReceiver 类型,等等。您不应直接实现事件接收器类型;而应该从适当的接收器类继承,然后实现派生的类。请注意,所有 SharePoint 事件接收器类都是从一个事件接收器基类继承的,这个类就是 SPEventReceiverBase

SharePoint Foundation 的事件接收器在编写完之后,将被编译为事件接收器程序集,并部署到全局程序集缓存 (GAC)。事件接收器还必须在它们处理事件的范围内注册。

事件的对象模型

事件处理程序类型不在任何事件处理程序命名空间中。事件处理程序所在的命名空间就是与其相关联 SharePoint 对象所在的命名空间。例如,所有顶级 SharePoint 对象(SPWeb、SPSite、SPList 等)连同其相关联的事件处理程序类型都在 Microsoft.SharePoint 命名空间中。请注意,事件接收器类型的命名约定符合上述我们熟悉的模式,即,以"EventReceiver"一词为后缀的 <object name>。通过这种方式,像 SPWorkflowEventReceiver 和 StyleLibraryEventReceiver 这样的事件接收器类型就易于标识和理解。

警告注释警告

事件接收器命名规则有一些例外。例如,SharePoint 功能的事件接收器名为 SPFeatureReceiver,而不是我们可以预期的 SPFeatureEventReceiver。

事件接收器类型也与事件属性包相关联,事件属性包允许访问指定事件的各种属性。事件属性包通常名为 <object name>,以"EventProperties"作为后缀。典型的事件接收器属性包有 SPWebEventPropertiesSPListEventProperties 等。

关于使用 SharePoint 事件的文档