{"id":1943,"date":"2009-02-05T19:46:00","date_gmt":"2009-02-05T19:46:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/dotnet\/2009\/02\/05\/catch-rethrow-and-filters-why-you-should-care\/"},"modified":"2021-10-04T16:06:32","modified_gmt":"2021-10-04T23:06:32","slug":"catch-rethrow-and-filters-why-you-should-care","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/catch-rethrow-and-filters-why-you-should-care\/","title":{"rendered":"Catch, Rethrow and Filters – Why you should care?"},"content":{"rendered":"

 <\/font><\/p>\n

<\/span><\/p>\n

A very common pattern in the usage of managed exception handling is that of catching an exception, inspecting it’s type and rethrowing it once you realize it was not the exception you wanted to handle. Below is such an example (and should be avoided in preference to another approach described further below in the writeup) that uses CustomBaseException <\/i>as the base type of an exception hierarchy and CustomDontWantToCatchException <\/i>as a type that derives from the base class that you wouldn’t want to catch:<\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

    <\/span>private static void Foo()<\/p>\n

<\/font><\/font><\/span><\/i><\/b><\/p>\n

    <\/span>{<\/p>\n

<\/font><\/font><\/span><\/i><\/b><\/p>\n

        <\/span>try<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>{<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>\/\/ Set some program state<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>\/\/ Do some work that can possibly throw an exception<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>}<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>finally<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>{<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>\/\/ Reset the program state <\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>}<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

    <\/span>}<\/p>\n

<\/font><\/font><\/span><\/i><\/b><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

   <\/span> <\/span>public static void Main()<\/b><\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

    <\/span>{<\/p>\n

<\/font><\/font><\/span><\/i><\/b><\/p>\n

        <\/span>try<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>{<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>Foo();<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>}<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>catch (CustomBaseException ex)<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>{<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>if (ex is CustomDontWantToCatchException)<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

                <\/span>throw; \/\/ Rethrow since we dont want to handle exceptions we aren’t interested in!<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>else<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>{<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

                <\/span>\/\/ handle the exception<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>}<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>}<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

    <\/span>}<\/p>\n

<\/font><\/font><\/span><\/i><\/b><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

Managed exception handling comprises of two passes:<\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

1.<\/font>       <\/span><\/span><\/span>In the first pass, the CLR looks for a handler for the thrown exception. When one is found, it begins the second pass.<\/p>\n

<\/font><\/font><\/span><\/p>\n

2.<\/font>       <\/span><\/span><\/span>In the second pass, also known as the unwind pass<\/i>, it invokes all the termination handlers<\/i> (e.g. managed finally\/fault blocks, along with the native counterparts like __finally<\/i>, destructors of stack allocated objects) that lie between the handler of the exception and the point at which the exception was thrown.<\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

Thus, if you use a pattern like the one above, only to rethrow an exception <\/i>since it was decided not to deal with it, prior to your [catch] handler being invoked, the termination handlers <\/i>will be invoked. These handlers would end up doing the cleanup (like reset program state) before control is returned to the handler that agreed to handle the exception. Hence, by the time you enter the catch block, <\/i>like in the example above, program state would have been modified since the finally <\/i>in Foo <\/i>would have been invoked. Thus, type handlers (like a catch clause) are invoked after the second pass has successfully been completed even though they are located in the first pass.<\/i><\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

Assuming the exception was CustomDontWantToCatchException<\/i>, the catch block <\/i>proceeds to rethrow it, expecting it to go unhandled. When exceptions go unhandled, it is a good thing – and that is because we get the actual program state at the time when the exception was thrown. However, <\/i>when pattern like the one above is used to rethrow conditionally, the program state gets modified and when the rethrown exception becomes unhandled, you will see actual program state from the point of rethrow and not <\/i>the original throw.<\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

So, how do we address such conditional exception processing without affecting program state for better diagnostics (in case the exception goes unhandled)?<\/p>\n

<\/font><\/span><\/i><\/b><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

Filters! Not really well known and not used a lot, managed filters are invoked by the CLR in the first pass<\/i> when it is looking for a handler for an exception. While  <\/span>a type handler is associated with a concrete type <\/i>based upon which the CLR will decide<\/i> whether the handler is capable of handling the exception or not, a filter can have custom logic<\/i> to determine whether it wants to handle the exception or not.<\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

When a filter is found in the first pass, the CLR will pass it the exception object corresponding to the thrown exception. The filter can then decide whether it wants to handle the exception or not, by accessing the state on the exception object (Note: accessing global program state from within a filter may lead to unexpected results. Thus, any such accesses should be avoided from within a filter)<\/i>. Once it has decided, a boolean is returned back to the CLR indicate its decision. If it agrees to handle the exception, the CLR will proceed to trigger the second (or unwind) pass. But if it decides not <\/i>to handle the exception, the CLR will continue look further on the stack for any handler that may want to handle the exception. If none are found, the exception becomes unhandled and <\/font><\/span>CLR’s unhandled exception processing<\/font><\/span><\/a> kicks in. <\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

Hence, instead of catching all exceptions as shown in the example above (or using base type of a given exception hierarchy) and then rethrowing the caught exception because you didn’t want to handle it, write a filter that will enable you to do just that without triggering the second pass and modifying program state in the process.<\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

And how does one write a managed filter?<\/p>\n

<\/font><\/span><\/i><\/b><\/p>\n


While the CLR support filters, not all managed languages support it – IL and VB, for instance, do support it but C# does not! Rewriting the Main <\/i>method above in VB , we can see how easy it can be to inspect an exception on the fly without affecting the program state and conditionally deciding whether, or not, to handle the exception:<\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

 <\/span>Function ShouldCatch(ByVal exception As CustomBaseException) As Boolean<\/b><\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>If TypeOf (exception) Is CustomDontWantToCatchException Then<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>Return False<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>Else<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>Return True<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>End If
 <\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

End Function<\/p>\n

<\/font><\/font><\/span><\/i><\/b><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

Sub Main()<\/p>\n

<\/font><\/font><\/span><\/i><\/b><\/p>\n

        <\/span>Try<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>Foo()<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>Catch ex As CustomBaseException When ShouldCatch(ex) = True<\/span><\/i><\/p>\n

<\/span><\/i><\/font><\/font><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

            <\/span>Console.WriteLine(“Caught exception!”)<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

        <\/span>End Try<\/p>\n

<\/font><\/font><\/span><\/i><\/p>\n

End Sub<\/p>\n

<\/font><\/font><\/span><\/i><\/b><\/p>\n

 <\/p>\n

<\/font><\/font><\/span><\/p>\n

<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

  A very common pattern in the usage of managed exception handling is that of catching an exception, inspecting it’s type and rethrowing it once you realize it was not the exception you wanted to handle. Below is such an example (and should be avoided in preference to another approach described further below in the […]<\/p>\n","protected":false},"author":342,"featured_media":58792,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[685],"tags":[],"class_list":["post-1943","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet"],"acf":[],"blog_post_summary":"

  A very common pattern in the usage of managed exception handling is that of catching an exception, inspecting it’s type and rethrowing it once you realize it was not the exception you wanted to handle. Below is such an example (and should be avoided in preference to another approach described further below in the […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/1943","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/342"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=1943"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/1943\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/58792"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=1943"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=1943"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=1943"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}