使用模組來包含方案中的檔案
在某些情況下,您可能會想將檔案部署至 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 檔案包含下列項目:
項目名稱 |
說明 |
---|---|
Elements |
包含模組中定義的所有項目。 |
Module |
Module 項目具有單一屬性 Name,這個屬性會以 <Module Name="Module1"> 格式指定模組的名稱。
注意事項
如果您變更模組的名稱 (或其 Folder Name 屬性),則必須手動更新 Module 項目中的名稱。
如果您在 Module 項目中指定了檔案的子目錄,Windows SharePoint Services (WSS) 會自動為它們建立相符的目錄結構。 |
File |
File 項目有兩個參數:Path 和 Url。
屬性名稱說明
PathSharePoint 方案中檔案的名稱和位置。格式為 Path="Module1\Sample.txt"。
URLSharePoint 伺服器上將用來部署檔案的位置。格式為 Url="Module1/Sample.txt"。
Type此選用屬性有兩個設定:GhostableInLibrary 和 Ghostable。格式為 Type="GhostableInLibrary"。指定 GhostableInLibrary 表示當檔案加入至 SharePoint 中的文件庫時,會隨檔案一起加入清單項目。指定 Ghostable 則會將檔案加入至 SharePoint 文件庫以外的地方。
|
您要部署的每個檔案都需要在 Elements.xml 中有個別的 <File> 項目。