有的时候需要用 Clip 属性来填充 Grid 控件,或其它支持成批加载的控件。可以使用 GetClipString 方法返回一个分隔字符串,包括结果集的 'n' 行。然后该串被应用到目标控件的 Clip 属性,该属性将数据从结果集中置入到目标控件。
按照 NumRows 参数,GetClipString 方法返回结果集的 'n' 个数据行组成的串。如果要求返回的数据行多于有效的行数,那么只返回有效的行数。通过 RowCount 属性可以确定实际取到的行数。可以取到的数据行数要受到可用内存的限制,还要适合相应的应用程序。如果表或结果集很庞大,那么不要一次把它们都装进内存。
通常,GetClipString 方法类似于 GetRows,只是它返回的不是一个二维变体型数组,而是一个字符串。GetClipString 可用于填充一个 grid 控件或其它具有 Clip 属性的控件。将数据从结果集导出到顺序文件时,可以用它来进行格式化。
完成 GetClipString 调用后,当前行指针指向下一个未读过的行。这与 Move(行数)方法是等价的。
如果要多次调用 GetClipString,取得所有的数据行,可以通过 EOF 属性确定是否还存在有效行。如果 GetClipString 返回的行数少于所要求的行数,要么是因为已经到达 rdoResultset 尾部,要么是因为在要求的范围内不能再取得数据。例如,假如要取得十行,但是第五行是取不到的,那么 GetClipString 将返回四行数据,并把当前指针指向出现问题的那一行。这时不会产生运行时错误。
ColumnDelimiter 任选参数可以定义一个列分隔符,缺省的符号是 tab (Chr$(9);RowDelimiter 任选参数可以定义一个行分隔符。在使用接收剪贴、但是分隔符不同的控件时,这是非常有用的(某些 grid 需要一个回车符和一个换行符作为行分隔符)。