数据窗口常用函数资料文档.pptVIP

数据窗口常用函数 数据窗口控件事务对象 1. SetTransObject函数 调用格式：dwcontrol.SetTransObject(transaction) 其中：dwcontro为数据窗口控件的名称；transaction为缺省的或 用户定义的事务对象。 返回值：1-成功；-1-失败。 SetTransObject函数为数据库维持了一个开放性的连接，不需要反复连接和断开数据库，对数据窗口的更新进行提交或滚回操纵。只有在用户改变数据窗口对象或者用户断开与数据库连接后，才要再次调用SetTransObject函数。 SetTransObject ()函数的特点是，在使用之前要求建立事务对象与数据库的连接，一直保持这一连接，直到代码执行DISCONNECT语句后才断开与数据库的连接。它在检索和更新数据时所花的时间只是检索和更新所需的时间，效率上明显高于SetTrans ()函数。 例如，在完成了数据库的连接之后，如果在某个窗口中有个数据窗口控件dw_1，可以在窗口打开的open事件中，添加如下代码： dw_1.SetTransObject(SQLCA) 此后，就可以使用其它函数访问数据库了。 数据窗口控件事务对象 2. SetTrans函数 调用格式：dwcontrol.SetTrans(transaction) 参数及返回值与SetTransObject函数相同。不同点是SetTrans使用内部事务对象，用户不必先进行数据库的连接，而是每进行一次数据库操作，都会自动产生一个数据库的连接，并在操作结束时自动断开与数据库的连接。每当操作数据库时，都会完成连接、操作、断开数据库这一系列步骤。 对绝大多数数据库管理系统来说，CONNECT、DISCONNECT操作是件极为耗时的工作。如果应用程序对数据库操作频繁，SetTrans需要花费的资源比较多，效率比较低。一般应用在远端使用应用程序或者对数据库操作较少的场合。 数据窗口控件的函数 数据窗口控件提供了丰富的对象函数，这些函数在增强数据窗口功能的同时，也方便了应用程序的开发，加快了开发进度。 数据窗口函数编程注意事项： 1. 窗口函数触发数据窗口事件 窗口函数会触发某些数据窗口事件，如果在这些数据窗口事件中调用能够触发该事件的数据窗口函数，就会造成死循环。 2. PowerBuilder的数据处理机制 数据窗口在客户机的本地内存中开辟了四个缓冲区：主缓冲区、删除缓冲区、过滤缓冲区、原始缓冲区，从数据库中检索到数据后，数据窗口根据不同情况把数据放置到不同的缓冲区。四个缓冲区各司其职，协作完成数据的增删改，最后把结果提交给数据库管理系统。 除了在数据窗口画笔中可以定义数据窗口对象外，还提供了根据SQL SELECT语句和指定的属性动态创建数据窗口的能力，这样，应用程序就能够构造的更加灵活，以适应千变万化的用户需求。 7.4 数据窗口控件的函数 当使用数据窗口控件的Retrieve()函数从数据库中提取数据后，数据被存入了数据窗口的主缓冲区中，程序对数据窗口中数据的操作均在缓冲区中完成。 用户在向数据窗口中输入数据时，并没有直接把数据输入到数据窗口的主缓冲区中，而是把数据输入到悬浮在数据窗口当前单元上面的编辑控件中，当用户移动了输入焦点或代码中使用AcceptText ()函数操作之后，系统验证输入数据的有效性，通过有效性验证的数据才被放置到数据窗口控件的主缓冲区中。 当插入数据时，插入的数据也存放在主缓冲区。当删除数据行时，不管是使用DeleteRow()函数直接删除一行还是使用RowsMove()函数在缓冲区之间移动数据行，被删除数据行从主缓冲区移动到删除缓冲区。 当使用数据窗口控件的对象函数Update()将数据窗口的修改发送到数据库管理系统后，被成功删除的记录均从删除缓冲区中清除。在保存数据时，删除缓冲区用于生成DELETE语句。过滤缓冲区用于保存那些满足数据源定义，而不满足过滤条件的行。 原始缓冲区保存数据窗口从数据库中检索出的原始数据。可以通过把GetItem簇函数的入口参数originalvalue设置为true来访问原始缓冲区中数据。 7.4 数据窗口控件的函数 数据窗口缓冲区之间的关系见图。 7.4 数据窗口控件的函数 主缓冲区的记录行数可以通过数据窗口控件的对象函数RowCount()得到，删除缓冲区的记录行数通过数据窗口控件的对象函数DeletedCount()得到，过滤缓冲区的记录行数通过数据窗口控件的对象函数FilterCount()得到。 利用数据窗口控件的对象函数SetFilter()，可以动态改变过滤条件，然后使用数据窗口控件的对象