|
前言:很多场景下,我们都需要对一篇文章或者文档的点击次数进行统计,然而SharePoint本身并没有给我们设计这样一个字段,所以我们需要通过简单的字段开发来实现这样一个功能。
一、创建项目:
1. 创建一个空的SharePoint项目,添加一个“SharePoint映射文件夹”,映射到Template/Xml下,用来保存我们对于字段描述的xml。
2. 添加一个xml到映射的xml文件夹下,名字为fldtypes_字段名,前面的名字必须是这样规则,才会被SharePoint所识别,xml模板附后。
3. 添加一个VisitorRecord.cs文件继承自SPField字段,添加一个VisitorRecordControl.cs文件继承自BaseFieldControl。
4. 项目结构,如下图:
二、添加代码
1. 添加Xml描述
VisitorRecord
Text
浏览次数
每点击一次DispForm页,浏览次数+1
TRUE
TRUE
TRUE
TRUE
VisitorRecord.VisitorRecord,VisitorRecord, Version=1.0.0.0, Culture=neutral, PublicKeyToken=a3d395e8da16bea6
2. 添加VisitorRecord方法,如下表格:
class VisitorRecord : SPField
{
public VisitorRecord(SPFieldCollection fields, string fieldName)
: base(fields, fieldName)
{
Init();
}
public VisitorRecord(SPFieldCollection fields, string typeName, string displayName)
: base(fields, typeName, displayName)
{
Init();
}
void Init()
{
//设置在DisplayForm页显示
this.ShowInDisplayForm = true;
//设置在EditFrom页不显示
this.ShowInEditForm = false;
//在NewForm页不显示
this.ShowInNewForm = false;
}
public override BaseFieldControl FieldRenderingControl
{
get
{
BaseFieldControl vr1 = new VisitorRecordControl();
vr1.FieldName = this.InternalName;
return vr1;
}
}
}
3. 添加VisitorRecordControl类代码
class VisitorRecordControl : BaseFieldControl
{
public void UpdateItemFieldValue()
{
try
{
SPSecurity.RunWithElevatedPrivileges(delegate()
{
using (SPSite site = new SPSite(SPContext.Current.Site.ID))
{
using (SPWeb web = site.OpenWeb(SPContext.Current.Web.ID))
{
web.AllowUnsafeUpdates = true;
SPList list = web.Lists[this.ListId];
SPListItem item = list.GetItemById(this.ItemId);
if (item == null) return;
if (ItemFieldValue != null)
item[this.FieldName] = (Convert.ToInt32(this.ItemFieldValue.ToString()) + 1).ToString();
else
item[this.FieldName] = "1";
item.SystemUpdate();
web.AllowUnsafeUpdates = false;
}
}
});
}catch{}
}
protected override void Render(System.Web.UI.HtmlTextWriter output)
{
if (this.ControlMode == SPControlMode.Display)
{
this.UpdateItemFieldValue();
if (this.ItemFieldValue != null)
{
output.Write(this.ItemFieldValue.ToString());
}
else
{
output.Write("0");
}
}
}
}
三、显示效果介绍:
1. 新建项目,并没有显示我们的自定义字段,因为隐去了;
2. 所有项目页面,我们的视图里有这个字段,可以看到每个项目的访问量;
3. 点击详细页面,可以看到访问量,并且会+1;
4. 编辑页面下,也没有显示这个字段;
四、字段其他介绍:
1. 字段类型
可以看到我们一开始继承的字段类型,是SPField类型,这个是基础字段类型,当然,我们可以继承SharePoint已经存在的内置字段类型,如下表:
单行文本 – SPFieldText
多行文本 – SPFieldMultiLineText
数字 – SPFieldNumber
货币 – SPFieldCurrency
是/否 – SPFieldBoolean
日期 - SPFieldDateTime
选项(单选) - SPFieldChoice
2. 字段结构:
基本,我们可以理解SharePoint的字段有一个GAC下文件(xxx.dll),一个字段描述性文件(fldtypes_xxx.xml)在Template/xml下,可能还有一个用户控件(xxx.ascx),在TEMPLATE/CONTROLTEMPLATES下。
3. 一些其他方法或事件
//判断输入值的有效性
public override string GetValidatedString(object value)
//重写字段默认值
public override string DefaultValue
//该字段是否允许被爬网
public override bool NoCrawl
//字段删除时执行的事件
public override void OnDeleting()
//字段添加后执行的事件
public override void OnAdded()
//字段更新后执行的事件
public override void OnUpdated()
五、参考文档:
http://msdn.microsoft.com/zh-cn/library/gg132914.aspx
http://www.cnblogs.com/flowman/archive/2012/10/31/2748049.html
|
|
|