Skip to main content

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 GetSelectedKeysOnPage and 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 the client GetSelectedKeysOnPage method (returns keys only on a visible page) and the number of rows on a page obtained through the clientGetVisibleRowsOnPage 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