WSS 3.0 SDK 深度解析：Feature.xml 結構與屬性完整指南

Feature.xml 核心角色

每個 SharePoint Feature 的定義核心，Feature.xml 中的 <Feature> 元素宣告 Feature 身分、範圍、相依組件、元素清單與屬性包。位於 12\TEMPLATE\FEATURES\FeatureName\ 目錄下。

Feature 元素完整屬性表

子元素結構

ActivationDependencies：啟用相依性

宣告本 Feature 啟用所需的其他 Feature：

<ActivationDependencies>
  <ActivationDependency FeatureId="11111111-1111-1111-1111-111111111111" />
</ActivationDependencies>

• 相依 Feature 若為 Hidden 且未啟用 → 自動啟用；最後一個相依者停用時一併停用。
• 相依 Feature 若為 可見 → **不自動啟用**，需手動啟用。
• Hidden Feature **不能**有自己的 ActivationDependencies。
• **不支援跨範圍**相依（如 Web 範圍相依 Site 範圍）。

ElementManifests：元素清單與檔案

• <ElementManifest Location="..." />：包含 Feature 元素定義的 XML 檔（如 ListTemplate、ContentType、Field 定義）。
• <ElementFile Location="..." />：支援性檔案（如 .aspx、.js、.css、圖片），不解析為元素定義，僅部署至 12 Hive。

Properties：Feature 屬性包

鍵值對集合，啟用時可由事件接收器讀取：

<Properties>
  <Property Key="Color" Value="Blue" />
  <Property Key="Shape" Value="Triangle" />
</Properties>

完整範例

<Feature
  Id="11111111-1111-1111-1111-11111111111"
  Title="Location Services"
  Description="This Feature contains lists and parts that let you link location data to your customer lists."
  Scope="Web">
  <ActivationDependencies>
    <ActivationDependency FeatureId="11111111-1111-1111-1111-111111111111" />
  </ActivationDependencies>
  <ElementManifests>
    <ElementManifest Location="Location\LocationPart.xml" />
    <ElementManifest Location="CustomerLocation\CustomerLocationList.xml" />
    <ElementFile Location="test.aspx" />
  </ElementManifests>
  <Properties>
    <Property Key="Color" Value="Blue" />
    <Property Key="Shape" Value="Triangle" />
  </Properties>
</Feature>

重要限制與注意事項

• Feature 資料夾與檔名**僅支援低位 ASCII，不可含空格**。
• RequireResources 僅影響 UI 顯示，**不阻擋 stsadm 命令列或物件模型啟用**。
• Site Definition 內的 Feature 不受 RequireResources 強制約束，需自行確保資源完整。
• 語言代碼格式遵循 IETF 標籤：ll-Ssss-CC（如 zh-TW、en-US）。

掌握 Feature.xml 結構，是開發可部署、可國際化、可相依管理的 SharePoint Feature 基石。