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