一个简单的Checkbox Custom Field Type

这个字段是一个普通的Single line of text，作用就是显示一个Checkbox，checkbox 的value为这个Text字段的值。
效果图：




下面介绍制作过程：

1. 首先，写一个派生自标准Field Type的类，

 1    public class SPCheckboxField : SPFieldText
 2    {
 3        public SPCheckboxField(SPFieldCollection fields, string fieldName)
 4            : base(fields, fieldName)
 5        {
 6        }
 7
 8        public SPCheckboxField(Microsoft.SharePoint.SPFieldCollection fields, string typeName, string displayName)
 9            : base(fields, typeName, displayName)
10        {
11        }
12
13        public override Microsoft.SharePoint.WebControls.BaseFieldControl FieldRenderingControl
14        {
15            get
16            {
17                Microsoft.SharePoint.WebControls.BaseFieldControl checkboxFieldControl = new CheckboxFieldControl();
18                checkboxFieldControl.FieldName = InternalName;
19                return checkboxFieldControl;
20            }
21        }
22    }

2. 写一个UC 命名为CheckboxField.ascx：

1<%@ Control Language="C#" Debug="true" %>
2<%@ Assembly Name="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
3<%@ Register TagPrefix="SharePoint" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" Namespace="Microsoft.SharePoint.WebControls" %>
4
5<SharePoint:RenderingTemplate ID="CheckboxFieldControl" runat="server">
6    <Template>
7        <asp:TextBox ID="txtUrl" Enabled="false" MaxLength="255" runat="server" Columns="50" />
8    </Template>
9</SharePoint:RenderingTemplate>

3. 写一个对应CheckboxField.ascx 的类：

 1  public class CheckboxFieldControl : BaseFieldControl
 2    {
 3        protected TextBox txtUrl;
 4
 5        protected override string DefaultTemplateName
 6        {
 7            get
 8            {
 9                return "CheckboxFieldControl";
10            }
11        }
12
13        public override object Value
14        {
15            get
16            {
17                EnsureChildControls();
18                return txtUrl.Text.Trim();
19            }
20            set
21            {
22                EnsureChildControls();
23                txtUrl.Text = (string)this.ItemFieldValue;
24            }
25        }
26
27        public override void Focus()
28        {
29            EnsureChildControls();
30            txtUrl.Focus();
31        }
32
33        protected override void CreateChildControls()
34        {
35            if (Field == null) return;
36           base.CreateChildControls();
37
38            if (ControlMode == Microsoft.SharePoint.WebControls.SPControlMode.Display)
39                return;
40
41            txtUrl = (TextBox)TemplateContainer.FindControl("txtUrl");
42
43            if (txtUrl == null)
44                throw new ArgumentException("txtUrl is null. Corrupted CheckboxField.ascx file.");
45
46            txtUrl.TabIndex = TabIndex;
47            txtUrl.CssClass = CssClass;
48            txtUrl.ToolTip = Field.Title;
49        }
50    }

4. 写一个xml:
fldtypes_CheckboxField.xml注意名字必须以fldtypes_开头.

 1<?xml version="1.0" encoding="utf-8"?>
 2<FieldTypes>
 3    <FieldType>
 4        <Field Name="TypeName">CheckboxField</Field>
 5        <Field Name="ParentType">Text</Field>
 6        <Field Name="TypeDisplayName">Checkbox Field</Field>
 7        <Field Name="TypeShortDescription">Checkbox Field</Field>
 8        <Field Name="UserCreatable">TRUE</Field>
 9        <Field Name="ShowInListCreate">TRUE</Field>
10        <Field Name="ShowInSurveyCreate">TRUE</Field>
11        <Field Name="ShowInDocumentLibraryCreate">TRUE</Field>
12        <Field Name="ShowInColumnTemplateCreate">TRUE</Field>
13        <Field Name="Sortable">FALSE</Field>
14        <Field Name="AllowBaseTypeRendering">TRUE</Field>
15        <Field Name="Filterable">FALSE</Field>
16        <Field Name="FieldTypeClass">CheckboxCustomField.SPCheckboxField,CheckboxCustomField,Version=1.0.0.0,Culture=neutral,PublicKeyToken=5acbdc949ff711be</Field>
17        <RenderPattern Name="DisplayPattern">
18            <Switch>
19                <Expr>
20                    <Column/>
21                </Expr>
22                <Case Value="">
23                </Case>
24                <Default>
25                    <HTML><![CDATA[<input type='checkbox' name='my_select' value=']]></HTML>
26                    <Column HTMLEncode="TRUE"/>
27                    <HTML><![CDATA[' />]]></HTML>
28                </Default>
29            </Switch>
30        </RenderPattern>
31    </FieldType>
32</FieldTypes>

   都是些配置的信息，最主要显示的部分是这里：

1                    <HTML><![CDATA[<input type='checkbox' name='my_select' value=']]></HTML>
2                    <Column HTMLEncode="TRUE"/>
3                    <HTML><![CDATA[' />]]></HTML>

5. 这样就OK了，开始部署：
    1) 将编译后dll放入GAC
    2) 把UC放到C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES
    3) 把xml放到C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\XML
    4) 重启IIS

在create column会看到我们的Checkbox Field:

红色的就是这个custom field type，蓝色的是陈曦那个。