WSS3SDK之：通过Feature创建一个自定义列表定义

本任务中将演示如何创建一个自定义列表模板的Feature，并将其添加到创建页面中的可供选择的可用列表模板中。添加一个自定义列表定义需要您提供下列3个文件:

• Feature.xml 用于注册列表模板。

• Elements.xml 将列表模板添加到创建页面中。

• Schema.xml 定义了该列表的架构，与哪些内容类型相关联，字段和视图的定义，窗体和工具栏的引用等。

步骤

1. 在Local_Drive:/Program Files/Common Files/Microsoft Shared/web server extensions/12/TEMPLATES/FEATURES 下创建一个文件夹，起个合适的名字，比如SimpleListFeature。

2. 在新文件夹里创建一个IFeature.xml 文件，指定 title, ID, 和Feature的scope，以及 Elements.xml 文件的位置，如下所示：

   <Feature Title="Simple List Feature" Id="GUID" Scope="Web" xmlns="http://schemas.microsoft.com/sharepoint/">
   <ElementManifests>
   <ElementManifest Location="Elements.xml" />
   </ElementManifests>
   </Feature>

3. 用新创建的GUID替换上面的 GUID 占位符。通过运行 guidgen.exe可以得到一个新的GUID，该命令行工具位于Local_Drive:/Program Files/Microsoft Visual Studio 8/Common7/Tools下。

4. 在新文件夹里创建一个 Elements.xml 文件来标识列表模板，并指定其显示在创建页面中的信息。 给它指定一个大于10000的Type 值，并且不要与其他自定义列表定义的值相同。

   <Elements>
   <ListTemplate Name="SimpleList" DisplayName="Simple List" Type="10001"
   Description="This is my simple list." BaseType="0" OnQuickLaunch="FALSE" SecurityBits="11" />
   </Elements>

    

5. 创建一个子文件夹，名称与前面指派给列表模板的名字一样，比如， SimpleList。

6. 在该子文件夹中新建一个 Schema.xml 文件，定义该列表。

7. 在命令行中，输入下列命令来安装并在特定子网站上激活该Feature。
   a. stsadm -o installfeature -filename SimpleListFeature/Feature.xml
   b. stsadm -o activatefeature -name SimpleListFeature -url http://Server/Site/Subsite

8. 通过导航到创建页面来看看效果，可以通过套用该模板创建一个列表。

Schema.xml 文件

在Schema.xml的开头部分定义了列表所需的任何自定义字段，如下面例子中为该列表定义了一个选项类型的字段：

<List Name="SimpleList" Title="Simple List" BaseType="0" Direction="" Url="">
<MetaData>
<Fields>
<Field Type="Choice" Name="FavoriteColor" DisplayName="Favorite Color">
<CHOICES>
<CHOICE>Red</CHOICE>
<CHOICE>Green</CHOICE>
<CHOICE>Blue</CHOICE>
</CHOICES>
</Field>
</Fields>
<Views>
<View BaseViewID="1" Type="HTML" WebPartZoneID="Main"
DisplayName="$Resources:core,objectiv_schema_mwsidcamlidC24;"
DefaultView="TRUE" SetupPath="pages/viewpage.aspx"
ImageUrl="/_layouts/images/generic.png" Url="AllItems.aspx">

添加该字段的一个引用到ViewFields一节中，以便将该字段显示在列表视图和列表项窗体中。

<ViewFields>
<FieldRef Name="DocIcon"/>
<FieldRef Name="Attachments"/>
<FieldRef Name="LinkTitle"/>
<FieldRef Name="FavoriteColor"/>
</ViewFields>

您可以拷贝一个已有列表定义的 Schema.xml 文件，然后在此基础上进行修改。通过这种方法可以快速创建出一个自定义的列表。