WSS3SDK之：Feature事件

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在調用時會建立一個列表，您的代碼就要確保如果列表已存在時啟用操作不會出錯。