SharePoint：扩展DVWP 第5部分：在保存操作提交前做些事情——PreSaveAction()

有时用户会在我们设想的顺序之前点击确定。不管是需要在保存数据前先进行验证，还是要抓一些其他的信息，或者是创建一个通知让用户知道一些事情，都可以利用SharePoint的一个内置功能，该功能允许我们在保存信息被提交前截取确认按钮的点击事件。

事实上，我们甚至可以在标准的默认列表表单（类似NewItem.aspx等等）上使用该功能，除非你根本就不打算进入编辑状态。

PreSaveAction()

在SharePoint里默认的保存（或确定）按钮会在进行其他操作前首先调用PreSaveAction()，它是个空函数。所以，我们可以利用它来在列表项保存之前做些事情，甚至如果需要的话可以阻止其保存。

只需简单的将PreSaveAction（）Javascript函数添加到页面上的一个内容编辑器WebPart （简称CEWP）里即可。如下：

<script language="javascript" type="text/javascript">
function PreSaveAction() {
    // 做一些事情 - 在接下来的博文中，你将看到建议在这里做的事
    return true; //如果事情进展顺利…
    //或
    return false; // 如果事情进行的有问题…
}
</script>

在DVWP中使用PreSaveAction()

如果你一直关注扩展DVWP系列的话，一定很关心这个功能在DVWP中该怎么使用。在一个DVWP的列表表单操作中，不会调用PreSaveAction()，但是我们可以让它去调用，同样也很简单。

若要从一个表单操作链接中调用PreSaveAction()，只需在GenFireServerEvent调用前添加一个到它调用即可。

即，从原来的：

<a href="javascript: {ddwrt:GenFireServerEvent('__commit')}">保存文件</a>

变成：

<a href="javascript: if(PreSaveAction()) {ddwrt:GenFireServerEvent('__commit')}">保存文件</a>

通过把该调用放置在if条件里，我们可以确保当我们不想后面的部分运行时就不会运行。也就是说，我们实现了与开箱即用的确定按钮同样的功能。

运行效果

最极端的一个实验，如果将PreSaveAction()写成下面这样：

function PreSaveAction()
{
    alert("不允许修改！");
    return false;
}

就可以从页面层次阻止用户对列表数据的修改了。以下是在EditForm.aspx中点击“确定”按钮的运行效果：

在数据视图Web部件中点击“保存文件”链接时的运行效果：

下一篇中：我们将讨论如果在DVWP的列表表单操作中使用工作流。

参考资料

SharePoint: Extending the DVWP – Part 5: Doing Stuff Before Save on Submit – PreSaveAction()