Skip to main content
A newer version of this page is available. .

ASPxClientGridView.DeleteRowByKey(key) Method

Deletes a row with the specified key value.

Declaration

DeleteRowByKey(
    key: any
): void

Parameters

Name Type Description
key any

An object that uniquely identifies the row.

Remarks

Once the DeleteRowByKey method is called, the ASPxGridView.RowDeleting event is raised. It allows you to cancel the delete operation. After a row has been deleted, the ASPxGridView.RowDeleted event is raised.

End-users can delete rows by clicking the Delete command.

Example

This example demonstrates how to use the ASPxClientGridView.GetSelectedKeysOnPage  and ASPxClientGridView.GetVisibleRowsOnPage methods to prevent a user from deleting all rows on a single grid page (if editing logic requires it). To do this, you can compare the array length of keys obtained through GetSelectedKeysOnPage client method (returns keys only on a visible page) and the number of rows on a page obtained through GetVisibleRowsOnPage client method.

function DeleteSelectedRows(s, e) {
    var keys = GridView.GetSelectedKeysOnPage();
    var rowsCount = GridView.GetVisibleRowsOnPage();
    if (keys.length == rowsCount) {
        alert('You cannot delete all rows on a page!');
        GridView.UnselectRowsByKey(keys);
    } else {
        if (confirm('Are you sure you want to delete rows with keys: [' + keys.toString() + ']')) {
            alert('Data editing is not allowed in this demo!');
            keys.forEach(function (key, index) {
                GridView.DeleteRowByKey(key);
            });
        }
    }
};
See Also