WSS3SDK之：如何通过Feature预置一个文件

想要在SharePoint网站中预先放置一个文件，您必须用到Feature或站点定义中的Module元素。 Module 元素允许您添加一个或多个文件，或文件集，到SharePoint网站或文档库中。

注意：

WSS 3.0最大支持通过Feature预置1000个文件，无论是1000个模块分别包含1个文件，还是一个模块包含了1000个文件。

Module 元素包含了 File 元素，用来定义每个预置的文件，也可以是一些需要添加的WebPart的定义。如果您将文件通过Module预置到子文件夹，WSS会自动确保目录结构已创建，来匹配您的文件。

通过 Module 元素您既可以预置文件到文档库，也可以添加一般的文件（如default.aspx）到文档库以外的位置。当添加到文档库时，您必须指定 File 元素的属性

Type="GhostableInLibrary"

。这个设置告诉WSS当把文件添加到库中之后创建一个对应得列表项。如果您是要在文档库以外放置文件，则指定

Type="Ghostable"

。

下面的例子将预置一些新的母版页到母版页库。

Feature.xml

<Feature Id="947F6C32-E898-45f5-A595-C46F07DA6BF7"

Title="New Master Pages"

Scope="Web"

xmlns="http://schemas.microsoft.com/sharepoint/">

<ElementManifests>

<ElementManifest Location="newmasterpages.xml" />

</ElementManifests>

</Feature>

newmasterpages.xml

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

<Module Name="MPages" List="116" Url="_catalogs/masterpage">

<File Url="Minimal.master" Type="GhostableInLibrary" />

<File Url="ContosoRed.master" Type="GhostableInLibrary" />

</Module>

</Elements>

下面的例子来自一个WSS 2.0的网站定义，展示了如何通过Onet.xml文件预置一个文件。您要区分出放在本地硬盘上的文件和预置的文件。请注意 default.aspx 存放在

dws/default.aspx

是相当于站点定义的根，但是它被预置到网站的根

/default.aspx

。

该例子同时也展示了如何使用View元素来包含列表视图WebPart，或任意WebPart（AllUsersWebPart元素，用于添加非列表视图WebPart）到页面中。该例还包含了NavBarPage元素，用于声明该页为SharePoint网站的主页。

<Module Name="DWS" Url="" Path="dws">

<File Url="default.aspx">

<View List="104" BaseViewID="3" WebPartZoneID="Top"/>

<View List="103" BaseViewID="3" WebPartZoneID="Right" WebPartOrder="2"/>

<View List="101" BaseViewID="6" WebPartZoneID="Left">

<![CDATA[

<WebPart xmlns="http://schemas.microsoft.com/WebPart/v2">

<Title>Members</Title>

</WebPart>

]]>

</View>

<View List="107" BaseViewID="7" WebPartZoneID="Left" WebPartOrder="2"/>

<AllUsersWebPart WebPartZoneID="Right" WebPartOrder="1">

<![CDATA[

<WebPart xmlns="http://schemas.microsoft.com/WebPart/v2">

<Assembly>Microsoft.SharePoint, Version=11.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c</Assembly>

<TypeName>Microsoft.SharePoint.WebPartPages.MembersWebPart</TypeName>

<Title>Members</Title>

<Description>Use the Members Web Part to see a list of the site members and their online status.</Description>

<FrameType>Standard</FrameType>

<IsVisible>true</IsVisible>

</WebPart>

]]>

</AllUsersWebPart>

<NavBarPage Name="Home" ID="1002" Position="Start"> </NavBarPage>

<NavBarPage Name="Home" ID="0" Position="Start"> </NavBarPage>

</File>

</Module>

预置一个文件夹

通过Module元素的 Url 属性可以预置把文件夹作为模块的一部分来预置。下面的例子将在一个网站中预置一个名为MyImages的文件夹，其中包含了一个特定的图片文件。

<Module Name="MyImage" Url="MyImages" Path="">

<File Url="MyImage.jpg" Type="GhostableInLibrary" />

</Module>