jQWidgets jqxScheduler beginAppointmentsUpdate() 方法

beginAppointmentsUpdate()方法是jQWidgets的jqxScheduler组件提供的一个方法之一。该方法用来开启日程更新事务。在执行该方法后，可以对日程的内容和属性进行修改，而不会立即刷新。

语法

dataAdapter.beginAppointmentsUpdate();

参数

该方法不需要任何参数。

返回值

该方法没有返回值。

使用场景

日程更新事务可以确保在实际更新操作执行之前，可以对大量日程的更新进行批量操作。如果没有该事务，每次更新都需要重新加载整个日程表面板，并引起较大的性能开销。

在以下场景中，可以使用beginAppointmentsUpdate()方法：

• 对多个日程进行属性的修改。
• 处理复杂的日程内容更新操作。
• 日程的内部嵌套对象需要进行批量更新操作。

示例代码

var dataAdapter = new $.jqx.dataAdapter(source);
dataAdapter.beginAppointmentsUpdate();

// 修改第一个日程的信息
var appointment = dataAdapter.records[0];
appointment.location = 'New York';
appointment.subject = 'New Subject';

// 修改第二个日程的信息
var appointment = dataAdapter.records[1];
appointment.location = 'Los Angeles';
appointment.subject = 'New Meeting Subject';

// 提交更新到后台
dataAdapter.commitAppointmentsUpdate();

在上述代码中，我们首先使用beginAppointmentsUpdate()方法开启了日程事务，接着对第一个和第二个日程进行了属性的修改。最后使用commitAppointmentsUpdate()方法提交更新到后台。

注意事项

• 在调用该方法后，必须使用commitAppointmentsUpdate()方法提交更新操作，否则该更新操作不会生效。
• 如果是非常简单的更新操作，不需要使用日程更新事务，可以直接通过jqxScheduler组件提供的方法完成更新。
• 在beginAppointmentsUpdate()方法和commitAppointmentsUpdate()方法之间，必须使用jqxScheduler提供的API接口进行修改和更新操作，否则可能会导致更新操作失败或产生意外结果。

参考资料

• jqxScheduler - beginAppointmentsUpdate()