ListViewInsertedEventArgs.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 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 Property ExceptionHandled As Boolean

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.

Sub ContactsListView_ItemInserted(ByVal sender As Object, ByVal e As ListViewInsertedEventArgs)

  If e.Exception IsNot Nothing Then

    If e.AffectedRows = 0 Then
      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."
    End If

    e.ExceptionHandled = True
  End If
End Sub

.NET Framework
Available since 3.5
Return to top
Show: