SharePoint2010内容类型剖析（四）
更新內(nèi)容類型
SharePoint允許對(duì)內(nèi)容類型進(jìn)行修改，即使已經(jīng)將內(nèi)容類型部署到網(wǎng)站、列表或已經(jīng)創(chuàng)建了相應(yīng)的列表項(xiàng)。
更新內(nèi)容類型的2條標(biāo)準(zhǔn)途徑
途徑1：對(duì)內(nèi)容類型進(jìn)行修改，并推送更新。這條途徑主要用在對(duì)使用中的內(nèi)容類型進(jìn)行有針對(duì)性的，離散的變更。比如，需要在網(wǎng)站內(nèi)容類型上添加一列。
途徑2：新建一個(gè)內(nèi)容類型，以滿足變更的需求。然后把原來(lái)的內(nèi)容類型加到_Hidden組。這條途徑主要用在需要徹底替換原有內(nèi)容類型，但是還需要保留已有的列表數(shù)據(jù)的情況下。比如，我們有一個(gè)已經(jīng)用了數(shù)年的產(chǎn)品規(guī)格內(nèi)容類型。現(xiàn)在，不得不變更產(chǎn)品的規(guī)格，以便體現(xiàn)新的要求。但由于歷史的原因，我們?nèi)匀灰Ａ粼械漠a(chǎn)品規(guī)格內(nèi)容類型，因?yàn)橹耙呀?jīng)有無(wú)數(shù)的列表項(xiàng)是基于它來(lái)創(chuàng)建的。這時(shí)，我們可以新建一個(gè)內(nèi)容類型叫產(chǎn)品規(guī)格2010。然后通過(guò)Feature打包分發(fā)，并在激活的代碼中通過(guò)程序?qū)⑿碌膬?nèi)容類型添加到所有舊內(nèi)容類型存在的列表中。然后將原來(lái)的產(chǎn)品規(guī)格內(nèi)容類型的Hidden屬性設(shè)為true。這樣，當(dāng)用戶創(chuàng)建產(chǎn)品規(guī)格時(shí)，他們只能選擇產(chǎn)品規(guī)格2010，原先的產(chǎn)品規(guī)格不在列出。但是，原先的列表項(xiàng)卻保持不變。
SharePoint提供了一種機(jī)制，允許通過(guò)改變SPContentType或ContentType對(duì)象的ReadOnly 和Sealed屬性來(lái)控制變更。因此，在修改內(nèi)容類型前，應(yīng)該首先檢查這些屬性設(shè)置。
將更新內(nèi)容類型的代碼放在SPFeatureReceiver對(duì)象的FeatureActivated(SPFeatureReceiverProperties)方法內(nèi)。在完成對(duì)相應(yīng)對(duì)象中內(nèi)容類型的修改后，要記得調(diào)用該對(duì)象的Update方法將變更提交到數(shù)據(jù)庫(kù)中。我們可以在Update方法中指定是否要更新子內(nèi)容類型。
SharePoint并不會(huì)將內(nèi)容類型的更新寫回到內(nèi)容類型定義文件，而是存在SharePoint數(shù)據(jù)庫(kù)中。所有的列表內(nèi)容類型也都是存放在SharePoint數(shù)據(jù)庫(kù)中的。因此，任何時(shí)候都不要更改已經(jīng)安裝并激活使用的內(nèi)容類型的定義文件。SharePoint不會(huì)跟蹤這種變化。
使用對(duì)象模型更新內(nèi)容類型
- 使用對(duì)象模型可以提供更細(xì)的推送粒度。
- 記得調(diào)用Update方法將變更寫回?cái)?shù)據(jù)庫(kù)。
- 無(wú)法通過(guò)修改Feature XML文件中的網(wǎng)站內(nèi)容類型定義來(lái)添加欄
{
????SPList?oList?=?oWebsite.GetList("MyWebSite/Lists/MyList");
????SPFieldCollection?collFields?=?oWebsite.Fields;
????//新建一個(gè)網(wǎng)站欄
????string?strNewColumn?=?collFields.Add("出處",?SPFieldType.Text,?false);
????//添加到網(wǎng)站內(nèi)容類型“消息”中
????SPFieldLink?oFieldLink?=?new?SPFieldLink(fields[strNewColumn]);
????SPContentType?oContentType?=?oList.ContentTypes["消息"];
????oContentType.FieldLinks.Add(oFieldLink);
????oContentType.Update(true);
}
內(nèi)容類型中的自定義信息
- 按照設(shè)計(jì)初衷，內(nèi)容類型是可擴(kuò)展的。
- 每個(gè)內(nèi)容類型都有一個(gè)XML集，用于存儲(chǔ)第三方解決方案中用到的一些信息（XML節(jié)點(diǎn)所代表的XmlDocument元素）。通過(guò)添加XML節(jié)點(diǎn)，可以為內(nèi)容類型加入自定義信息。通過(guò)在內(nèi)容類型中包含自定義的XmlDocument元素，可以將我們解決方案中所需的自定義信息進(jìn)行一個(gè)封裝，使其成為內(nèi)容類型的一部分。
可以通過(guò)兩種方式為內(nèi)容類型添加自定義信息：- 對(duì)于已經(jīng)部署好的內(nèi)容類型，我們可以通過(guò)OM以編程的方式訪問(wèn)該集合中的Xml。只需要調(diào)用SPXmlDocumentCollection的Add方法即可。
- 對(duì)于未進(jìn)行部署的內(nèi)容類型，我們可以在內(nèi)容類型架構(gòu)定義XML中添加一個(gè)XmlDocument元素。
- 內(nèi)容類型可以包含任何數(shù)目的XmlDocument元素。每個(gè)XmlDocument可以有自己的架構(gòu)，只要是有效的XML即可。
- 網(wǎng)站內(nèi)容類型中包含的XmlDocument內(nèi)容會(huì)自動(dòng)復(fù)制到任何子代。推送的粒度也可以基于Xml節(jié)點(diǎn)。但是，SharePoint在覆蓋該xml節(jié)點(diǎn)前不會(huì)去判斷該節(jié)點(diǎn)是否正在被使用或是否為某個(gè)處理過(guò)程所必需。我們也可以刪除某個(gè)xml，并作為變更推送下去。
關(guān)聯(lián)工作流
SPContentType.WorkflowAssociations 屬性返回一個(gè)SPWorkflowAssociationCollection對(duì)象代表了內(nèi)容類型所關(guān)聯(lián)的所有工作流。我們可以通過(guò)Id屬性或GetAssociationByName方法取到其中某個(gè)工作流。每個(gè)集合內(nèi)的工作流的Name是唯一的。通過(guò)GetAssociationByName的返回值判斷是否重名。
代碼
{
????contentType.WorkflowAssociations.Add(workflowAssociation);
}
else
{
????contentType.WorkflowAssociations.Update(workflowAssociation);
}
?
實(shí)例：創(chuàng)建一個(gè)工作流關(guān)聯(lián)，將其添加到某個(gè)網(wǎng)站內(nèi)容類型的工作流集合，然后推送到子代內(nèi)容類型
(注意：在新建項(xiàng)目的框架版本選擇時(shí)要選擇.Net Framework 3.5，還需要添加Microsoft.SharePoint.dll的引用)。下圖是實(shí)例中要用到的工作流模板，首先要確保其已激活。
點(diǎn)擊查看大圖
?
完成后查看工作流關(guān)聯(lián)，可以看到下圖：
點(diǎn)擊查看大圖
?
以下是添加關(guān)聯(lián)的代碼：
代碼 using?System;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["費(fèi)用報(bào)告"];
????????????string?taskListTitle?=?"任務(wù)";
????????????string?historyListTitle?=?"工作流歷史記錄";
????????????string?workflowName?=?"紅-黃-綠";
????????????//?獲取一個(gè)模板.
????????????SPWorkflowTemplate?workflowTemplate?=?null;
????????????foreach?(SPWorkflowTemplate?template?in?site.WorkflowTemplates)
????????????{
????????????????workflowTemplate?=?template;
????????????????//?這里找一個(gè)自帶的模板.
????????????????if?(workflowTemplate.Name?==?"三態(tài)")?break;
????????????}
????????????if?(workflowTemplate?!=?null)
????????????{
????????????????//?創(chuàng)建一個(gè)關(guān)聯(lián).
????????????????SPWorkflowAssociation?workflowAssociation?=?SPWorkflowAssociation.CreateWebContentTypeAssociation(workflowTemplate,?workflowName,?taskListTitle,?historyListTitle);
????????????????//?添加一個(gè)關(guān)聯(lián)到該內(nèi)容類型，如果關(guān)聯(lián)已存在則更新它.
????????????????Console.Write("工作流?{0}?已關(guān)聯(lián)?",?workflowAssociation.Name);
????????????????if?(siteContentType.WorkflowAssociations.GetAssociationByName(workflowAssociation.Name,?site.Locale)?==?null)
????????????????{
????????????????????siteContentType.WorkflowAssociations.Add(workflowAssociation);
????????????????????Console.WriteLine("添加.");
????????????????}
????????????????else
????????????????{
????????????????????siteContentType.WorkflowAssociations.Update(workflowAssociation);
????????????????????Console.WriteLine("更新.");
????????????????}
????????????????//?將工作流關(guān)聯(lián)更新推送到子代內(nèi)容類型.
????????????????siteContentType.UpdateWorkflowAssociationsOnChildren(false,??//?不需要生成完整變更清單
?????????????????????????????????????????????????????????????????????true,???//?推送到繼承的子代網(wǎng)站內(nèi)容類型
?????????????????????????????????????????????????????????????????????true,???//?推送到列表內(nèi)容類型
?????????????????????????????????????????????????????????????????????false);?//?如果遇到密封或只讀內(nèi)容類型不拋異常??
????????????}
????????????site.Dispose();
????????????siteCollection.Dispose();
????????????Console.WriteLine();
????????????Console.Write("任意鍵繼續(xù)...");
????????????Console.ReadLine();
????????}
????}
}
以下代碼刪除剛才關(guān)聯(lián)的工作流：
代碼 using?System;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?=?"費(fèi)用報(bào)告";
????????????????????string?wfName?=?"紅-黃-綠";
????????????????????SPContentType?contentType?=?web.ContentTypes[ctName];
????????????????????if?(null?!=?contentType)
????????????????????{
????????????????????????SPWorkflowAssociation?wfAssociation?=
????????????????????????????contentType.WorkflowAssociations.GetAssociationByName(wfName,?web.Locale);
????????????????????????if?(null?!=?wfAssociation)
????????????????????????{
????????????????????????????//?移除該工作流關(guān)聯(lián).
????????????????????????????contentType.WorkflowAssociations.Remove(wfAssociation);
????????????????????????????Console.WriteLine("與工作流?{0}?的關(guān)聯(lián)已移除.",?wfAssociation.Name);
????????????????????????}
????????????????????????else
????????????????????????{
????????????????????????????Console.WriteLine("名為?{0}?的工作流關(guān)聯(lián)未找到.",?wfName);
????????????????????????}
????????????????????}
????????????????????else
????????????????????{
????????????????????????Console.WriteLine("內(nèi)容類型?{0}?不存在.",?ctName);
????????????????????}
????????????????????//?將工作流關(guān)聯(lián)更新推送到子代內(nèi)容類型.
????????????????????contentType.UpdateWorkflowAssociationsOnChildren(false,?true,?true,?false);?
????????????????}
????????????}
????????????Console.Write("\n任意鍵繼續(xù)...");
????????????Console.ReadLine();
????????}
????}
}
內(nèi)容類型XML架構(gòu)定義
- 應(yīng)用一：可以在Feature中通過(guò)內(nèi)容類型的SchemaXml 新建一個(gè)內(nèi)容類型定義。
- 應(yīng)用二：可以通過(guò)List定義中的ContentTypes元素在創(chuàng)建列表時(shí)自動(dòng)附加一個(gè)已有的內(nèi)容類型
網(wǎng)站內(nèi)容類型定義中引用的欄或內(nèi)容類型可以包含在另一個(gè)Feature里。這種情況下，我們要注意創(chuàng)建相應(yīng)的激活依賴性。
?
內(nèi)容類型架構(gòu)定義位于C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\XML\wss.xsd
點(diǎn)擊查看大圖
?
可以打開ctypewss.xml(位于%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES\ctype)。其中包含了大多數(shù)SharePoint內(nèi)置的內(nèi)容類型定義。我們可以將其做為一個(gè)很好的學(xué)習(xí)內(nèi)容類型架構(gòu)的例子。
點(diǎn)擊查看大圖
轉(zhuǎn)載于:https://www.cnblogs.com/Sunmoonfire/archive/2010/05/19/1738815.html
總結(jié)
以上是生活随笔為你收集整理的SharePoint2010内容类型剖析（四）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇： ZooKeeper学习-- Zookee
- 下一篇： IIS支持Shtml后辍文件方法