SMART datagrid v.1 > Classes > GridDataSet

DataLudi.GridDataSet.appendRows  method

将通过rows数组而传递的一个以上的数据行源数据，添加在数据组的最后一行之后，并且返回实际添加的行数。 包含在rows的各个行的数据可以是数组或JSON对象，而JSON对象将会根据字段顺序，整理和储存为数组。 

Returns

Integer - 实际添加的行数。

Parameters

rows - Array. required.

start - Number. 默认值为0.

count - Number. 默认值为-1.

rowEvents - Boolean. 默认值为false.

如果为true，就会以行为单位，触发确认以及终结事件。 如果为DataSet.undoable，就会无关该属性，将不会触发行单位的事件。

Note

• 如同调用insertRows(dataset.rowCount(), rows, start, count, rowEvents)。

    // 如果rowEvents为false，就会在提交所有行的添加时，触发事件。
    ds.onRowsInserted = function (ds, row, count) {
        console.log(row + '已在第 个行位置，添加' + count + '行。';
    };
    // 如果rowEvents为true，就会在每次添加各个行时，触发事件。
    ds.onRowInserted = function (ds, row) {
        console.log(row + '已在第 个行位置，添加一个行。';
    };
    
    // 通过函数而传递的各个行，可以是数组或JSON对象。
    var rows = [
        ['value1', 'value2', 'value3', 111, 222],
        {
            'field1': 'value11', 
            'field2': 'value12',
            'field3': 'value13',
            'field4': 666,
            'field5': 777
        }
    ];
    // 如果count为-1，就会添加rows的所有行，而如果大于0，就会添加相当于Math.min(count, rows.length)的数量。
    ds.appendRows(rows, 0, -1, false);

See Also

insertRows

appendRow

insertRow

Examples

网格数据组编辑