SharePoint2010内容类型剖析(四)
更新内容类型
SharePoint允许对内容类型进行修改,即使已经将内容类型部署到网站、列表或已经创建了相应的列表项。
更新内容类型的2条标准途径
途径1:对内容类型进行修改,并推送更新。这条途径主要用在对使用中的内容类型进行有针对性的,离散的变更。比如,需要在网站内容类型上添加一列。
途径2:新建一个内容类型,以满足变更的需求。然后把原来的内容类型加到_Hidden组。这条途径主要用在需要彻底替换原有内容类型,但是还需要保留已有的列表数据的情况下。比如,我们有一个已经用了数年的产品规格内容类型。现在,不得不变更产品的规格,以便体现新的要求。但由于历史的原因,我们仍然要保留原有的产品规格内容类型,因为之前已经有无数的列表项是基于它来创建的。这时,我们可以新建一个内容类型叫产品规格2010。然后通过Feature打包分发,并在激活的代码中通过程序将新的内容类型添加到所有旧内容类型存在的列表中。然后将原来的产品规格内容类型的Hidden属性设为true。这样,当用户创建产品规格时,他们只能选择产品规格2010,原先的产品规格不在列出。但是,原先的列表项却保持不变。
SharePoint提供了一种机制,允许通过改变SPContentType或ContentType对象的ReadOnly 和Sealed属性来控制变更。因此,在修改内容类型前,应该首先检查这些属性设置。
将更新内容类型的代码放在SPFeatureReceiver对象的FeatureActivated(SPFeatureReceiverProperties)方法内。在完成对相应对象中内容类型的修改后,要记得调用该对象的Update方法将变更提交到数据库中。我们可以在Update方法中指定是否要更新子内容类型。
SharePoint并不会将内容类型的更新写回到内容类型定义文件,而是存在SharePoint数据库中。所有的列表内容类型也都是存放在SharePoint数据库中的。因此,任何时候都不要更改已经安装并激活使用的内容类型的定义文件。SharePoint不会跟踪这种变化。
使用对象模型更新内容类型
- 使用对象模型可以提供更细的推送粒度。
- 记得调用Update方法将变更写回数据库。
- 无法通过修改Feature XML文件中的网站内容类型定义来添加栏
{
SPList oList = oWebsite.GetList("MyWebSite/Lists/MyList");
SPFieldCollection collFields = oWebsite.Fields;
//新建一个网站栏
string strNewColumn = collFields.Add("出处", SPFieldType.Text, false);
//添加到网站内容类型“消息”中
SPFieldLink oFieldLink = new SPFieldLink(fields[strNewColumn]);
SPContentType oContentType = oList.ContentTypes["消息"];
oContentType.FieldLinks.Add(oFieldLink);
oContentType.Update(true);
}
内容类型中的自定义信息
- 按照设计初衷,内容类型是可扩展的。
- 每个内容类型都有一个XML集,用于存储第三方解决方案中用到的一些信息(XML节点所代表的XmlDocument元素)。通过添加XML节点,可以为内容类型加入自定义信息。通过在内容类型中包含自定义的XmlDocument元素,可以将我们解决方案中所需的自定义信息进行一个封装,使其成为内容类型的一部分。
可以通过两种方式为内容类型添加自定义信息:
- 对于已经部署好的内容类型,我们可以通过OM以编程的方式访问该集合中的Xml。只需要调用SPXmlDocumentCollection的Add方法即可。
- 对于未进行部署的内容类型,我们可以在内容类型架构定义XML中添加一个XmlDocument元素。
- 内容类型可以包含任何数目的XmlDocument元素。每个XmlDocument可以有自己的架构,只要是有效的XML即可。
- 网站内容类型中包含的XmlDocument内容会自动复制到任何子代。推送的粒度也可以基于Xml节点。但是,SharePoint在覆盖该xml节点前不会去判断该节点是否正在被使用或是否为某个处理过程所必需。我们也可以删除某个xml,并作为变更推送下去。
关联工作流
SPContentType.WorkflowAssociations 属性返回一个SPWorkflowAssociationCollection对象代表了内容类型所关联的所有工作流。我们可以通过Id属性或GetAssociationByName方法取到其中某个工作流。每个集合内的工作流的Name是唯一的。通过GetAssociationByName的返回值判断是否重名。
代码
{
contentType.WorkflowAssociations.Add(workflowAssociation);
}
else
{
contentType.WorkflowAssociations.Update(workflowAssociation);
}
实例:创建一个工作流关联,将其添加到某个网站内容类型的工作流集合,然后推送到子代内容类型
(注意:在新建项目的框架版本选择时要选择.Net Framework 3.5,还需要添加Microsoft.SharePoint.dll的引用)。下图是实例中要用到的工作流模板,首先要确保其已激活。
点击查看大图
完成后查看工作流关联,可以看到下图:
点击查看大图
以下是添加关联的代码:
using Microsoft.SharePoint;
using Microsoft.SharePoint.Workflow;
namespace TestWorkflowAssociation
{
class ConsoleAdd
{
static void Main(string[] args)
{
Console.WriteLine();
SPSite siteCollection = new SPSite("http://sp2010u/sites/contoso/Docs");
SPWeb site = siteCollection.OpenWeb();
SPContentType siteContentType = site.ContentTypes["费用报告"];
string taskListTitle = "任务";
string historyListTitle = "工作流历史记录";
string workflowName = "红-黄-绿";
// 获取一个模板.
SPWorkflowTemplate workflowTemplate = null;
foreach (SPWorkflowTemplate template in site.WorkflowTemplates)
{
workflowTemplate = template;
// 这里找一个自带的模板.
if (workflowTemplate.Name == "三态") break;
}
if (workflowTemplate != null)
{
// 创建一个关联.
SPWorkflowAssociation workflowAssociation = SPWorkflowAssociation.CreateWebContentTypeAssociation(workflowTemplate, workflowName, taskListTitle, historyListTitle);
// 添加一个关联到该内容类型,如果关联已存在则更新它.
Console.Write("工作流 {0} 已关联 ", workflowAssociation.Name);
if (siteContentType.WorkflowAssociations.GetAssociationByName(workflowAssociation.Name, site.Locale) == null)
{
siteContentType.WorkflowAssociations.Add(workflowAssociation);
Console.WriteLine("添加.");
}
else
{
siteContentType.WorkflowAssociations.Update(workflowAssociation);
Console.WriteLine("更新.");
}
// 将工作流关联更新推送到子代内容类型.
siteContentType.UpdateWorkflowAssociationsOnChildren(false, // 不需要生成完整变更清单
true, // 推送到继承的子代网站内容类型
true, // 推送到列表内容类型
false); // 如果遇到密封或只读内容类型不抛异常
}
site.Dispose();
siteCollection.Dispose();
Console.WriteLine();
Console.Write("任意键继续...");
Console.ReadLine();
}
}
}
以下代码删除刚才关联的工作流:
using Microsoft.SharePoint;
using Microsoft.SharePoint.Workflow;
namespace TestWorkflowAssociation
{
class ConsoleDel
{
static void Main(string[] args)
{
using (SPSite site = new SPSite("http://sp2010u/sites/contoso/Docs"))
{
using (SPWeb web = site.OpenWeb())
{
string ctName = "费用报告";
string wfName = "红-黄-绿";
SPContentType contentType = web.ContentTypes[ctName];
if (null != contentType)
{
SPWorkflowAssociation wfAssociation =
contentType.WorkflowAssociations.GetAssociationByName(wfName, web.Locale);
if (null != wfAssociation)
{
// 移除该工作流关联.
contentType.WorkflowAssociations.Remove(wfAssociation);
Console.WriteLine("与工作流 {0} 的关联已移除.", wfAssociation.Name);
}
else
{
Console.WriteLine("名为 {0} 的工作流关联未找到.", wfName);
}
}
else
{
Console.WriteLine("内容类型 {0} 不存在.", ctName);
}
// 将工作流关联更新推送到子代内容类型.
contentType.UpdateWorkflowAssociationsOnChildren(false, true, true, false);
}
}
Console.Write("\n任意键继续...");
Console.ReadLine();
}
}
}
内容类型XML架构定义
- 应用一:可以在Feature中通过内容类型的SchemaXml 新建一个内容类型定义。
- 应用二:可以通过List定义中的ContentTypes元素在创建列表时自动附加一个已有的内容类型
网站内容类型定义中引用的栏或内容类型可以包含在另一个Feature里。这种情况下,我们要注意创建相应的激活依赖性。
内容类型架构定义位于C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\XML\wss.xsd
点击查看大图
可以打开ctypewss.xml(位于%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES\ctype)。其中包含了大多数SharePoint内置的内容类型定义。我们可以将其做为一个很好的学习内容类型架构的例子。
点击查看大图
转载于:https://www.cnblogs.com/Sunmoonfire/archive/2010/05/19/1738815.html
SharePoint2010内容类型剖析(四)相关推荐
- SharePoint2010 内容类型剖析
SharePoint 2010 在上一版本的基础上进一步发展了内容类型对象.本系列作为一个专题,试图对其进行一个深入的剖析.方便大家在自己的自定义解决方案中对其进行定制. 内容类型的定义 ShareP ...
- SharePoint2010 内容类型剖析(Content Type/ 內容類型)
原文地址:http://sharepoint410.wordpress.com/2011/01/06/sharepoint2010-%E5%86%85%E5%AE%B9%E7%B1%BB%E5%9E% ...
- SP2010开发和VS2010专家食谱--第四章节—列表定义和内容类型(7)--创建列表定义...
之前当我们部署内容类型时,我们不得不在SharePoint用户界面手动创建基于内容类型的列表.我们可以使用VS而不用SharePoint用户界面创建基于内容类型的列表实例. 转载于:https://w ...
- sharepoint 2010 内容类型
SharePoint 2010 在上一版本的基础上进一步发展了内容类型对象.本系列作为一个专题,试图对其进行一个深入的剖析.方便大家在自己的自定义解决方案中对其进行定制. 内容类型的定义 Share ...
- 服务器编写_编写下载服务器。 第六部分:描述您发送的内容(内容类型等)...
服务器编写 就HTTP而言,客户端下载的只是一堆字节. 但是,客户真的很想知道如何解释这些字节. 它是图像吗? 还是ZIP文件? 本系列的最后一部分描述了如何向客户端提示她下载的内容. 设置 内容类型 ...
- 返回值是内置类型 不能更改_选择通过更改内容类型返回的详细程度,第二部分...
返回值是内置类型 不能更改 在上一篇文章中 ,我们研究了如何使用MOXy的功能来控制特定实体的数据输出级别. 这篇文章着眼于Jersey 2.x提供的抽象,它允许您定义一组自定义的批注以具有相同的效果 ...
- 编写下载服务器。 第六部分:描述您发送的内容(内容类型等)
就HTTP而言,客户端下载的只是一堆字节. 但是,客户真的很想知道如何解释这些字节. 它是图像吗? 或者也许是ZIP文件? 本系列的最后一部分描述了如何向客户端提示她下载的内容. 设置 内容类型描述了 ...
- 选择通过更改内容类型返回的详细程度,第二部分
在上一篇文章中 ,我们研究了使用MOXy的功能来控制特定实体的数据输出级别. 这篇文章着眼于Jersey 2.x提供的抽象,它允许您定义一组自定义的批注以具有相同的效果. 与之前一样,我们几乎没有什么 ...
- SharePoint 2010中的内容类型集线器 - 内容类型发布与订阅
原文地址:http://www.chakkaradeep.com/post/SharePoint-2010-Content-Type-Hubs-e28093-Publish-and-Subscribe ...
最新文章
- 空气输入法!浙大最新研究:空中动动手指,就能给智能手表输入文本
- windows系统下jenkins环境搭建与基本使用
- Android中项目中各个文件夹的含义和用途详解
- Android Broadcast编写的音乐播放器
- 图标出问题_同是Office365,为什么你的软件图标还是旧版的?
- 蓝桥杯 数字三角形 贪心+动态规划
- E. Party Company(树上问题)
- 清华霸榜,长沙理工异军突起!第三届 CCF CCSP落下帷幕
- Atitit 文员招募规范 attilax总结
- Luogu3942 将军令
- unix linux_在Unix桌面环境中创建独特的Linux体验
- Android Hook框架adbi的分析(1)---注入工具hijack
- 盘点程序员的那些常用网站
- Pollard Rho 质因数分解
- 计算机科学精粹这本书有用吗,计算机科学精粹
- Problem N: 设计飞机类Plane及其派生类
- I.MX6ULL ARM驱动开发---platfrom设备驱动
- 【STL容器讲解—deque】
- 推荐:5款可以教你编程的游戏
- Word让目录页码和正文页码独立分开计算,分隔符中分页符、“下一页”分节符的区别与使用选择
热门文章
- mysql执行shell命令_关键Docker命令:使用Docker必须掌握的公认宝典
- 打印字符串(C语言,全排列)
- CentOS 6 rpm方式安装mysql
- java的lookAndfeel_java-LookAndFeel行为之间的区别
- could not find curses mysql_​-- Configuring incomplete-- Could NOT find Curses
- 到另一个文件夹 复制hdfs上的文件_HDFS——如何将文件从HDFS复制到本地
- python transform_Pandas的数据分组-transform函数
- python自己的模块_Python--构建发布自己的模块
- 系统启动数据库服务器,linux系统如何启动数据库服务器
- java安全增加url_规范化String以在Java中创建安全URL