一个简单的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，蓝色的是陈曦那个。