Edit

Share via


ListViewUpdatedEventArgs.KeepInEditMode Property

Definition

Gets or sets a value that indicates whether the ListView control should remain in edit mode after an update operation.

public:
 property bool KeepInEditMode { bool get(); void set(bool value); };
public bool KeepInEditMode { get; set; }
member this.KeepInEditMode : bool with get, set
Public Property KeepInEditMode As Boolean

Property Value

true if the control should remain in edit mode after an update operation; otherwise, false. The default is false.

Examples

The following example shows how to use the KeepInEditMode property to keep a ListView control in edit mode when an exception occurs. This code example is part of a larger example provided for the ListViewUpdatedEventArgs class.

void ContactsListView_ItemUpdated(Object sender, ListViewUpdatedEventArgs e)
{
    if (e.Exception != null)
    {
        if (e.AffectedRows == 0)
        {
            e.KeepInEditMode = true;
            Message.Text = "An exception occurred updating the contact. " +
                                "Please verify your values and try again.";
        }
        else
            Message.Text = "An exception occurred updating the contact. " +
                                "Please verify the values in the recently updated item.";

        e.ExceptionHandled = true;
    }
}
Sub ContactsListView_ItemUpdated(sender As Object, e As ListViewUpdatedEventArgs)
    If e.Exception IsNot Nothing Then
        If e.AffectedRows = 0 Then
            e.KeepInEditMode = True
            Message.Text = "An exception occurred updating the contact. " & _
                                "Please verify your values and try again."
        Else
            Message.Text = "An exception occurred updating the contact. " & _
                                "Please verify the values in the recently updated item."
        End If

        e.ExceptionHandled = True
    End If
End Sub

Remarks

By default, the ListView control returns to read-only mode after an update operation. Set the KeepInEditMode property to true to specify that the ListView control should remain in edit mode. This also preserves the values that the user has entered.

Applies to

See also