使用模組來包含解決方案中的檔案
有時候您可能會想要將檔案部署至 SharePoint 伺服器,而不論其檔案類型為何,例如新的主版頁面。 若要這樣做,您可以使用「模組」(不要與 Visual Basic 程式碼模組混淆)。 模組是 SharePoint 解決方案中檔案的容器。 部署解決方案時,模組中的檔案會複製到 SharePoint 伺服器上指定的資料夾。
模組項目和元素
若要建立模組,請在 [加入新項目] 對話方塊中選取該模組,將其新增至專案。 然後,修改其 Elements.xml 檔案,以包含您要部署的檔案名稱、這些檔案位於系統上的位置,以及應在 SharePoint 伺服器上複製這些檔案的位置。
以下是模組的 Elements.xml 檔案範例:
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
<Module Name="Module1">
<File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />
</Module>
</Elements>
新建立的模組包含下列預設檔案:
檔案名稱 | 描述 |
---|---|
Elements.xml | 模組的定義檔。 |
Sample.txt | 作為模組中檔案範例的預留位置檔案。 |
Elements.xml 檔案包含下列元素:
元素名稱 | 描述 |
---|---|
元素 | 包含模組中定義的所有元素。 |
模組 | 模組元素具有單一屬性 Name,其會以格式 <Module Name="Module1"> 指定模組的名稱。請注意,如果您變更模組的名稱 (或其「資料夾名稱」屬性),則必須手動更新模組元素中的名稱。 如果您為模組元素中的檔案指定子目錄,Windows SharePoint Services (WSS) 會自動為其建立相符的目錄結構。 |
檔案 | 檔案元素有兩個參數,即 Path 和 Url。 - Path:SharePoint 解決方案中檔案的名稱和位置。 格式為 Path="Module1\Sample.txt" 。- Url:將在 SharePoint 伺服器上部署檔案的位置。 格式為 Url="Module1/Sample.txt" 。- Type:具有兩個設定的選用屬性:GhostableInLibrary 和 Ghostable。 格式為 Type="GhostableInLibrary" 。 指定 GhostableInLibrary 表示檔案將會新增至 SharePoint 中的文件庫,連同該檔案新增至文件庫時伴隨其的清單項目。 指定 Ghostable 會導致檔案新增至文件庫外部的 SharePoint。 |
您想要部署的每個檔案都需要 Elements.xml 中的個別 <File>
專案項目。