ListViewUpdatedEventArgs.ExceptionHandled Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

public bool ExceptionHandled { get; set; }

Property Value

Type: System.Boolean

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

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.

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

.NET Framework
Available since 3.5
Return to top
Show: