ListViewInsertedEventArgs.ExceptionHandled Property

 

Gets or sets a that indicates whether an exception that was raised during the insert operation was handled in the event handler.

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.

When an exception is raised during the insert operation, use the ExceptionHandled property to indicate whether the exception was handled in the event handler. When this property is set to true, the exception is considered handled and is not re-thrown. 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 ListViewInsertedEventArgs object that is passed to the handler for the ItemInserted event to determine whether an exception was raised during the insert operation. This code example is part of a larger example provided for the ListViewInsertedEventArgs class.

void ContactsListView_ItemInserted(Object sender, ListViewInsertedEventArgs e)
{
  if (e.Exception != null)
  {
    if (e.AffectedRows == 0)
    {
      e.KeepInInsertMode = true;
      Message.Text = "An exception occurred inserting the new Contact. " +
        "Please verify your values and try again.";
    }
    else
      Message.Text = "An exception occurred inserting the new Contact. " +
        "Please verify the values in the newly inserted item.";

    e.ExceptionHandled = true;
  }
}

.NET Framework
Available since 3.5
Return to top
Show: