LinqDataSourceUpdateEventArgs.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 the exception was handled and that it should not be thrown again.

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; otherwise, false.

You can create an event handler for the Updating event to examine validation exceptions that occurred before the update operation. If you handle the exception and do not want it to be thrown again, set the ExceptionHandled property to true. If you do not set the ExceptionHandled property to true, the exception will be propagated to the next event handler in the call stack.

The following example shows an event handler for the Updating event. It displays any validation exception messages by using a Label control.

Protected Sub LinqDataSource_Updating(ByVal sender As Object, _
        ByVal e As LinqDataSourceUpdateEventArgs)
    If (e.Exception IsNot Nothing) Then
        For Each innerException As KeyValuePair(Of String, Exception) _
               In e.Exception.InnerExceptions
            Label1.Text &= innerException.Key & ": " & _
                innerException.Value.Message & "<br />"
        Next
        e.ExceptionHandled = True
    End If
End Sub

[C#]

protected void LinqDataSource_Updating(object sender, 
        LinqDataSourceUpdateEventArgs e)
{
    if (e.Exception != null)
    {
        foreach (KeyValuePair<string, Exception> innerException in 
             e.Exception.InnerExceptions)
        {
        Label1.Text += innerException.Key + ": " + 
            innerException.Value.Message + "<br />";
        }
        e.ExceptionHandled = true;
    }
}

.NET Framework
Available since 3.5
Return to top
Show: