ListViewUpdatedEventArgs.ExceptionHandled ListViewUpdatedEventArgs.ExceptionHandled ListViewUpdatedEventArgs.ExceptionHandled ListViewUpdatedEventArgs.ExceptionHandled Property

Definition

Gets or sets a value that indicates whether an exception that was raised during the update operation was handled during the event.

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

Property Value

true if the exception was handled in the event handler; otherwise, false. The default is false.

Examples

The following example shows how to use the ExceptionHandled property to indicate that the exception was handled in the event handler. 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

If an exception is raised during the update operation, use the ExceptionHandled property to indicate whether you have handled the exception during the event. If this property is set to true, the exception is considered handled and is not re-thrown by the ListView control. If this property is set to false, the ListView control re-throws the exception. To determine which exception was raised, use the Exception property.

Applies to

See also