自定义列表字段类型（3）
在上一次我們已經(jīng)編寫好了一個(gè)帶有格式驗(yàn)證功能的Email地址欄，那么如果需要用到這個(gè)自定義字段，必須先對(duì)其進(jìn)行注冊(cè)，通知SharePoint有了一個(gè)新的字段類型。其方法就是編寫一個(gè)xml文件。
先來看一下這個(gè)xml文件的內(nèi)容，再對(duì)其進(jìn)行一一介紹：
<?xml version="1.0" encoding="utf-8" ?>
<FieldTypes>
? <FieldType>
??? <Field Name="TypeName">EmailField</Field>
??? <Field Name="ParentType">Text</Field>
??? <Field Name="TypeDisplayName">Email Field</Field>
??? <Field Name="TypeShortDescription">Email</Field>
??? <Field Name="UserCreatable">TRUE</Field>
??? <Field Name="ShowInListCreate">TRUE</Field>
??? <Field Name="ShowInSurveyCreate">TRUE</Field>
??? <Field Name="ShowInDocumentLibraryCreate">TRUE</Field>
??? <Field Name="ShowInColumnTemplateCreate">TRUE</Field>
??? <Field Name="FieldTypeClass">EmailField.EmailFieldField,EmailField,Version=1.0.0.0,Culture=neutral,PublicKeyToken=9f4da00116c38ec5</Field>
??? <RenderPattern Name="DisplayPattern">
????? <HTML><![CDATA[<a href="mailto: ]]></HTML>
????? <Column HTMLEncode="TRUE" />
????? <HTML><![CDATA[">]]></HTML>
????? <Column HTMLEncode="TRUE" />
????? <HTML><![CDATA[</a>]]></HTML>
??? </RenderPattern>
? </FieldType>
</FieldTypes>
在“FieldType”一節(jié)中，定義了和該字段相關(guān)的內(nèi)容，可以看到其大致分為兩個(gè)部分：
第一部分是關(guān)于該字段類型的一些基本設(shè)定，比如類型名稱（TypeName）、父類型名稱（ParentType），
顯示名稱（TypeDisplayName）是指在列表設(shè)置頁面中顯示的名稱：
而簡(jiǎn)短描述（TypeShortDescription）則是在創(chuàng)建欄頁面中顯示的名稱：
是否允許用戶創(chuàng)建（UserCreatable）指定該字段類型是否可以在創(chuàng)建欄的頁面出現(xiàn)，允許用戶自行創(chuàng)建（而不是寫在列表模板的定義xml文件中）
后面一些就是設(shè)置該字段類型是否可以出現(xiàn)在某些列表類型中，比較重要的一個(gè)是FieldTypeClass，定義了該字段類型后臺(tái)對(duì)應(yīng)的類名和程序集名稱，注意都要使用全名，中間用逗號(hào)分開
而第二部分是通過一系列的RenderPattern設(shè)置該字段類型的顯示樣式。
RenderPattern大致分為幾種，HeaderPattern和FooterPattern定義了在視圖頁面顯示該字段時(shí)的欄的頭尾樣式，DisplayPattern定義了字段內(nèi)容的顯示樣式，EditPattern和NewPattern為編輯和新建時(shí)的樣式，以及PreviewDisplayPattern、PreviewEditPattern和PreviewNewPattern定義了在SharePoint Designer中的樣式。
可以注意到，這種樣式的定義是通過一種奇怪的可以用CDATA方式攙雜html代碼的形式定義的，對(duì)了，這又是CAML……其中出現(xiàn)的兩個(gè)Column結(jié)點(diǎn)表示該欄的內(nèi)容。
?
寫到這里，我們可以發(fā)現(xiàn)這個(gè)xml其實(shí)可以寫的很復(fù)雜，尤其是在RenderPattern的部分，因?yàn)镃AML允許我們?cè)诙x顯示樣式的時(shí)候使用switch條件，這部分的寫法很靈活，我們可以多多參考默認(rèn)的那些字段是怎么寫的（在fldtypes.xml中）。
此外，這個(gè)xml文件中還會(huì)涉及到自定義屬性和自定義屬性輸入界面的控制，這個(gè)放到相應(yīng)的部分再講。
另外，非常需要值得注意的，這個(gè)xml文件必須以“fldtypes_”開頭，才可以被SharePoint識(shí)別為字段類型的描述文件。
ok，現(xiàn)在我們把上次編譯出來的dll文件拽到GAC里，把這個(gè)xml文件放到12\TEMPLATE\XML目錄中，重啟iis（一定要iisreset，僅回收應(yīng)用程序池是不行的），然后我們就可以在創(chuàng)建欄的地方看到這個(gè)自定義字段類型了，并且它的表現(xiàn)也和我們期望的一致。
在新建界面中格式驗(yàn)證失敗時(shí)：
在顯示界面中：
并且，這個(gè)字段在編輯界面中無法看到（被我們?cè)诖a中屏蔽了）。
這兩次內(nèi)容綜合起來，我們可以編寫一個(gè)很簡(jiǎn)單的自定義字段類型了，它的功能僅僅是使用默認(rèn)的那些屬性、使用默認(rèn)的輸入界面，加上一些其他屬性的初始化功能和數(shù)據(jù)驗(yàn)證功能，在下一次中，我會(huì)介紹一下怎樣來自己編寫輸入界面。
轉(zhuǎn)載于:https://www.cnblogs.com/lmkong/archive/2008/07/14/1242164.html
總結(jié)
以上是生活随笔為你收集整理的自定义列表字段类型（3）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 《勇敢的心》原声
- 下一篇： 世纪佳缘，玫瑰和面包开始PK