使用模組來包含方案中的檔案

在某些情況下,您可能會想將檔案部署至 SharePoint 伺服器,而不論其檔案類型為何,例如新的主版頁面。若要這麼做,您可以使用「模組」(Module) (請勿與 Visual Basic 程式碼模組混淆)。模組是 SharePoint 方案中檔案的容器。部署方案時,模組中的檔案會複製到 SharePoint 伺服器上的指定資料夾。

模組項目 (Item) 和項目 (Element)

若要建立模組,請將它加入至專案加以選取。 [新增項目] 對話方塊。然後修改其 Elements.xml 檔案,以包含您要部署的檔案名稱、檔案在系統上的位置,以及應將檔案複製到 SharePoint 伺服器上的哪個位置。

以下是模組的 Elements.xml 檔案範例:

<?xml version="1.0" encoding="utf-8"?>

<Elements xmlns="https://schemas.microsoft.com/sharepoint/">

<Module Name="Module1">

<File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />

</Module>

</Elements>

新建立的模組包含下列預設檔案:

檔案名稱

描述

Elements.xml

模組的定義檔。

Sample.txt

做為模組中檔案範例的預留位置檔案。

Elements.xml 檔案包含下列項目:

項目名稱

描述

項目

包含模組中定義的所有項目。

模組

Module 項目具有單一屬性 Name,這個屬性會以 <Module Name="Module1"> 格式指定模組的名稱。

注意事項注意事項
如果您變更模組的名稱 (或其 Folder Name 屬性),則必須手動更新 Module 項目中的名稱。

如果您在 Module 項目中指定了檔案的子目錄,Windows SharePoint Services (WSS) 會自動為它們建立相符的目錄結構。

檔案

File 項目有兩個參數:Path 和 Url。

屬性名稱描述
路徑SharePoint 方案中檔案的名稱和位置。格式為 Path="Module1\Sample.txt"。
URLSharePoint 伺服器上將用來部署檔案的位置。格式為 Url="Module1/Sample.txt"。
型別此選用屬性有兩個設定:GhostableInLibrary 和 Ghostable。格式為 Type="GhostableInLibrary"。指定 GhostableInLibrary 表示當檔案加入至 SharePoint 中的文件庫時,會隨檔案一起加入清單項目。指定 Ghostable 則會將檔案加入至 SharePoint 文件庫以外的地方。

您要部署的每個檔案都需要在 Elements.xml 中有個別的 <File> 項目。

請參閱

工作

HOW TO:使用模組來包含檔案

其他資源

HOW TO:提供檔案

開發 SharePoint 方案

建立 SharePoint 的 Web 組件

封裝和部署 SharePoint 方案