7 developmnet Project with the 2007 Microsoft Office System and Windows SharePoint 2007翻译(1)-feature

WSS中的Feature

实现一个feature

为了实现一个新的Feature,你需要增加一个子目录到这个目录下“\program files\Common Files\microsoft shared\web server extensions\12\template\features”,这个子目录中包括这个新增feature的定义

这个子目录包括一个文件Feature.xml，它定义了这个feature和绑定到这个feature上的列表元素的属性，就象那些包括了元素的原数据和其他支持文件的XML文件一样。这个目录可能只包括Feature.xml文件，或者它可能包括Feature.xml和其他一下提供支持的元素文件，包括其他的XML文件或者.aspx,.htm,.xsn,.resx,.dll,或者其他的文件类型。

一旦创建这个feature的目录，你能够安装和激活这个feature.而安装这个feature使得整个server farm可以知道这个feature和它的定义.而激活它使这个feature在指定的范围内可用

feature 元素

就象上面提到的，一个feature包括feature.xml和其他描述元素的文件。这些feature元素被用在feature.xml中，用来定义这个feature并且指定这些库，文件，依赖，或者属性（译者：这些都是元素）的位置。这些feature元素也能被用在一个Onet.xml文件中，用来制定一个被包括在站点定义中的feature。

一个feature.xml文件通常指向一个或多个xml文件，这些文件的顶级元素标签包括了这些元素的定义。在Windows Sharepoint Services 3.0中的元素对应到Onet.xml或者Schema.xml中的具体节点。

一个feature能够包括几种元素，诸如自定义菜单项，事件句柄，内容类型，列表实例，等等。这些元素的集合操作和他们的关系定义了这个feature的功能，例如：一个叫做“my favorite items”的feature可能通过以下元素提供它的功能：

1，一个自定义地列表，它存储每个用户喜欢的项目。这个列表被作为一个隐藏列表而创建到没有工作区。

2，一个自定义的菜单项，名字叫做“Add To Favorites”，并被绑定到这个列表上

3，一个Web part实现使用和链接跟踪来显示用户最喜欢的10个项目

元素范围

Feature能够被限制在网站，网站集，Web应用程序，或者Server场。一个特定的feature能够激活在某个范围内。这个feature的范围被这个Feature元素的Scope属性的值来定义

1，网站和网站范围

一个网站的feature被限制在网站集。一个网站集feature包括能够应用到整个个网站集的项目，也包括能够在每个站点被激活的项目。网站或者网站集的元素包括列表定义（模板，视图，实例），模块（文件集），以及项目内容类型行为（例如,每个项目的自定义菜单选项和事件）

2，Web应用程序范围

在这个范围内的feature可以被激活或者失效，并且可以包括针对虚拟服务器库和虚拟服务器管理链接的元素

3，Server场范围

一个场feature被限制在整个server场中，不像在网站中的feature,它总是被默认激活。一个场feature包括在部署sharepoint时必须使用的元素。一个场feature能够包括连到_layouts页面，文件，_admin页面，和其他元素的链接。

激活依赖和范围

一个feature的激活有可能需要其它的feature。激活的依赖有可能是同一个范围的feature，也有可能是在不同范围的（一个跨范围的激活依赖）。例如：一个在站点范围的feature可以依赖于这个站点的站点集范围的feature.跨范围的激活依赖当被依赖的feature有更多受限范围时，不能生效。换句话说，一个站点集范围的feature不能依赖于站点范围的feature.

一个feature可以依赖于看得见或者看不见的feature（feature的隐藏被它的元素的隐藏属性决定）。然而隐藏feature本身不能有其它的依赖。

范围和feature全球化

为了支持文件，两种类型的资源需要被实现在feature中 。

本地资源被存储在feature目录的子目录中，feature目录在\template\features目录中

共享应用程序的feature和站点定义资源被保存在\web server extensions\12\resources，并且被设计来跨feature和跨站点定义的使用。

feature元素的Localeld属性指定了这个feature的语言。这个属性能够被设置为0，这个这个feature可以被所有语言使用。一个feature的开发者能够申明一个feature为culture-neutral，即使这个feature潜在的包括了本地化的资源。这样的feature可以在所有语言中显示。

这个语言支持文件集合和这个feature的默认语言一起组成了这个feature可以使用的语言集合。如果一个范围是服务器场或者web应用程序级的feature不支持管理用户界面的语言，将不能激活。一个范围是站点集的feature总是可以激活，因为站点集被认为天生是多语言的。一个范围是站点的feature,如果不支持这个站点的语言，将是无效的。

Feature.xml的结构

在这个文件中，这些feature元素定义了一个完整的feature,指定了类库，文件，依赖，或者支持这个feature的属性的位置。一个Feature.xml文件能够包括一下元素。

Feature

ActivationDependancies

ActivationDependency

ElementManifests

ElementFile

ElementManifest

ActivationDependencies元素指明了feature的依赖列表。ElementManifests指明了一个元素容器文件列表，这个文件包括了标记feature的操作的定义。

下表列出了元素的属性。

名称	数据类型	描述
Feature属性
Id	GUID	这个feature的唯一标示
Title	文本	Feature的标题，长度小于255
DefaultResourceFile	文本	可选，默认情况下，如果开发人员指定了在Feature.xml中的资源，wss会在Feature名称\Resources\Resources.Culture.resx。然而，通过DeafaultResourceFile，你可以指定另一个文件，通过它来获取资源。
Desciption	文本	可选，返回feature功能的描述
Version	版本	这个值最多由4个数字组成，用.分隔，表示一个版本
ReceiverAssembly	文本	可选。如果一个属性包括了ReceiverClass,这个属性指定了一个类库，这个类库将装载一个Receiver来处理feature的事件
ReceiverClass	文本	可选。如果一个属性包括了ReceiverAssembly,这个属性指定了一个类，这个类将实现feature事件的处理
ActivationDepency属性
FeatureId	Guid	依赖的feature的Id
Title	文本	可选。依赖的feature的标题，可以本地化。
Description	文本
Url	文本	一个Url包括这个feature的更多信息。
ElementFile属性
Location	文本	指定manifest文件的相对位置
ElementManifest属性
Location	文本

下面这个例子展示了一个Feature.xml文件，它包括了安装以来，特殊字段，以及元素定义文件的相对路径。

<Feature

Id="1111111-11111-11111-11111"

Title="Location Services"

Description="This feature contains lists and parts that let you link

location data to your customer lists."

Scope="Web">

<InstallationDependencies>

<InstallationDependency

Id="FEEDBADA-11111-111111"

Title="Portal Search"

Description="This feature contains portal search functionality"

Url="http://www.microsoft.com/sharepoint">

</InstallationDependency>

</InstallationDependencies>

<PropertySchema>

<Fields>

<Field

Type="Text"

Name="ProjectName"

DisplayName="Project Name">

</Field>

</Fields>

</PropertySchema>

<ElementManifests>

<ElementManifest Location="Location\LocationPart.xml"/>

<ElementManifest Location="CustomerLocation\CustomerLocationList.xml"/>

<ElementFile Location="test.aspx"/>

</ElementManifests>

</Feature>