如何：创建自定义列表定义

项目
06/15/2015

上次修改时间： 2010年7月9日

适用范围： SharePoint Foundation 2010

本文内容
创建字段定义
创建内容类型
从内容类型创建列表定义
部署列表定义

本任务说明如何通过使用 Microsoft Visual Studio 2010 中的 SharePoint 开发工具创建自定义列表模板功能。最佳做法是创建一个内容类型，并根据此内容类型创建列表定义。

创建字段定义

字段定义可定义出现在列表模板内部的列。有关用于定义字段类型的 XML 的详细信息，请参阅字段类型 XML。

创建字段定义

启动 Microsoft Visual Studio 2010。
在"文件"菜单上，指向"新建"，然后单击"项目"。
在"项目类型"的"Visual Basic"或"C#"下，选择"空白 SharePoint 项目"。
键入 FavoriteColorList 作为项目的名称。单击"确定"。
在"SharePoint 自定义向导"中选择"部署为沙盒解决方案"。单击"完成"。
在"解决方案资源管理器"中，右键单击"FavoriteColorList"项目，依次选择"添加"和"新建项"。
在"添加新项"对话框中，选择"空元素"模板，并键入 FavoriteColorField 作为名称。单击"添加"。

在 Elements 元素内插入以下 XML。此 XML 为内容类型定义一个字段。

重要信息
必须将 ID 属性中的 FieldId 替换为 GUID。若要生成 GUID，请单击"工具"，然后单击"创建 GUID"。

<Field ID="FieldId" Type="Choice" Name="FavoriteColor" DisplayName="Favorite Color" ShowInDisplayForm="TRUE" ShowInNewForm="TRUE" ShowInEditForm="TRUE">
  <CHOICES>
    <CHOICE>Red</CHOICE>
    <CHOICE>Green</CHOICE>
    <CHOICE>Blue</CHOICE>
    <CHOICE>Purple</CHOICE>
    <CHOICE>Magenta</CHOICE>
  </CHOICES>
</Field>

创建内容类型

内容类型定义要在列表内使用的项集合。有关内容类型的详细信息，请参阅内容类型。

创建内容类型

在"解决方案资源管理器"中，右键单击"FavoriteColorList"项目，依次选择"添加"和"新建项"。
在"添加新项"对话框中，选择"内容类型"模板，并键入 FavoriteColorContentType 作为名称。单击"添加"。
在"选择内容类型设置"对话框中，在"此内容类型应从哪一个基内容类型继承?"下拉列表框中选择"项"。单击"完成"。
在 FieldRefs 元素中，必须添加一个可引用先前定义的字段的 FieldRef 元素。以下 XML 添加对该字段的引用。

重要信息

FieldRef 元素的 ID 属性必须匹配 Field 元素的 ID 属性。
```
<FieldRef ID="FieldId" Name="FavoriteColor" />
```

重要信息
FieldRef 元素的 ID 属性必须匹配 Field 元素的 ID 属性。

从内容类型创建列表定义

在"解决方案资源管理器"中，右键单击"FavoriteColorList"项目，依次选择"添加"和"新建项"。
在"添加新项"对话框中，选择"来自内容类型的列表定义"模板，并键入 FavoriteColorListDefinition 作为名称。单击"添加"。
在"选择列表定义设置"对话框中，确保在"要为列表定义使用哪个内容类型?"下拉列表框中选择"FavoriteColorContentType"。
选中"为此列表定义添加列表实例"选项，然后单击"完成"。
接下来，打开已创建的"Schema.xml"文件。
在 ViewFields 元素中，添加您已添加到内容类型的同一个 FieldRef 元素。以下 XML 添加对该字段的引用。

重要信息

FieldRef 元素的 ID 属性必须匹配 Field 元素的 ID 属性。
```
<FieldRef ID="FieldId" Name="FavoriteColor" />
```