SharePoint API 中SPListItem的更新

使用SharePoint API来操作文件，列表对象时，都会用到更新的方法，SharePoint中在更新SPListItem有3个方法：

在微软的API文档上简单的解释了一下，但是实际在开发的使用中发现这几个API里面的问题有很多，因此工作这些年也遇到了很多坑，这里总结一下，并且对这些API做一些详细的说明。

Update方法

微软的解释是把对当前SPListItem的更改更新到数据库中，这里面更详细的说明下：

• 用来更新属性，此API可以更新属性，但是更新后Modified会变成当前时间和ModifiedBy为当前用户。如果开启了版本控制，会生成一个新的版本。

SPListItem splitemitem = list.GetItemById(1);

splitemitem["ColumnName"] = "TestValue";

splitemitem.Update();

• 用来添加SPLitemItem，这种情况必须要用这个方法。

SPList list = web.GetList("/lists/announcements");
SPListItemCollection items = list.Items;

SPListItem item = items.Add();
item[SPBuiltInFieldId.Title] = "A new item!";
item[SPBuiltInFieldId.Body] = "This item was added by a call to the Add method.";
item[SPBuiltInFieldId.Expires] = DateTime.Now.AddHours(1);
item.Update();

UpdateOverwriteVersion

使用Update会产生新的版本，因此UpdateOverwriteVersion方法可以避免这个问题：

SPListItem splitemitem = list.GetItemById(1);
splitemitem["ColumnName"] = "TestValue";
splitemitem.UpdateOverwriteVersion();

SystemUpdate

使用上面两个方法都会更改变当前SPLitemItem的Modified和ModifiedBy信息，因此需要SystemUpdate这个方法。

SPListItem splitemitem = list.GetItemById(1);
splitemitem["ColumnName"] = "TestValue";
splitemitem.SystemUpdate();

但是在真正的使用过程中，会有一些特殊情况，会影响到上述API的行为，比如在开启了Content Approval功能后，Approved状态的文件一旦被修改，就会增长一个版本。如果文件被签出，使用Update也不会有问题。因此实际在使用中需要根据具体情况来看。