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);
});
}
}
};