Windows SharePoint Services 3.0提供了Featue事件相關的類庫,可以允許您捕獲和相應Feature安裝到服務器場,添加到新的虛擬服務器或卸載等事件。
其中一些事件是 post 事件,也就是說在相應行為已經被提交或Feature定義已經在場的Feature集合中被創建後才觸發。
通過Feature事件不可能取消一個安裝或卸載操作。
Feature 事件類
Microsoft.SharePoint.SPFeatureReceiver 基礎抽象類可以被覆寫來捕獲Feature的激活,關閉,安裝,或卸載操作。命名空間:Microsoft.SharePoint
Microsoft.SharePoint.SPFeatureReceiverPropertIEs 類提供對事件屬性的訪問,比如已創建的Feature實例,Feature的定義,或Feature的父對象(比如,一個 Microsoft.SharePoint.SPWeb 對象)。 命名空間:Microsoft.SharePoint
Feature 提供的事件
Feature provisioning callouts 允許您編寫特定的代碼來響應各種在Feature整個生命周期內的事件。 SPFeatureReceiver 類提供了下列方法來處理事件:
FeatureInstalled
FeatureUninstalling
FeatureActivated
FeatureDeactivating
通過創建一個繼承自 SPFeatureReceiver 的類並實現這些方法就可以為Feature提供相應事件的處理。
您總是傳遞到父對象(比如一個父SPWeb)的指針,因此您可根據需要進行定制。
包含Feature接收器的DLL組件必須放在GAC裡。在 Feature.xml 文件裡,您可以通過 ReceiverAssembly 和 ReceiverClass 屬性在Feature元素的頂層注冊該接收器。比如:
<Feature Id="5E88AE4E-2ECB-4CC5-B9EC-9019250F5BC8"
Title="Knowledge Base Infrastructure"
Scope="Site"
ReceiverAssembly="MS.Samples.SharePoint.KnowledgeBase, Version=1.0.0.0, Culture=neutral, PublicKeyToken=d24e3c1752ded9ed"
ReceiverClass="MS.Samples.SharePoint.KnowledgeBase.KnowledgeBaseInstaller"
xmlns="http://schemas.microsoft.com/sharepoint/">
在激活過程中的任何異常的拋出都將傳達給用戶,並且該Feature不會被標記為已激活。
編寫代碼常常用來處理當用戶試圖強制激活一個已激活的Feature的情況。比如,如果您的Feature在調用時會創建一個列表,您的代碼就要確保如果列表已存在時激活操作不會出錯。