1 // This source code is dual-licensed under the Apache License, version
2 // 2.0, and the Mozilla Public License, version 1.1.
6 //---------------------------------------------------------------------------
7 // Copyright (C) 2007, 2008 LShift Ltd., Cohesive Financial
8 // Technologies LLC., and Rabbit Technologies Ltd.
10 // Licensed under the Apache License, Version 2.0 (the "License");
11 // you may not use this file except in compliance with the License.
12 // You may obtain a copy of the License at
14 // http://www.apache.org/licenses/LICENSE-2.0
16 // Unless required by applicable law or agreed to in writing, software
17 // distributed under the License is distributed on an "AS IS" BASIS,
18 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19 // See the License for the specific language governing permissions and
20 // limitations under the License.
21 //---------------------------------------------------------------------------
25 //---------------------------------------------------------------------------
26 // The contents of this file are subject to the Mozilla Public License
27 // Version 1.1 (the "License"); you may not use this file except in
28 // compliance with the License. You may obtain a copy of the License at
29 // http://www.rabbitmq.com/mpl.html
31 // Software distributed under the License is distributed on an "AS IS"
32 // basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
33 // License for the specific language governing rights and limitations
36 // The Original Code is The RabbitMQ .NET Client.
38 // The Initial Developers of the Original Code are LShift Ltd.,
39 // Cohesive Financial Technologies LLC., and Rabbit Technologies Ltd.
41 // Portions created by LShift Ltd., Cohesive Financial Technologies
42 // LLC., and Rabbit Technologies Ltd. are Copyright (C) 2007, 2008
43 // LShift Ltd., Cohesive Financial Technologies LLC., and Rabbit
46 // All Rights Reserved.
48 // Contributor(s): ______________________________________.
50 //---------------------------------------------------------------------------
52 using System.Collections;
54 namespace RabbitMQ.Client.Events
56 ///<summary>Describes an exception that was thrown during the
57 ///library's invocation of an application-supplied callback
61 /// When an exception is thrown from a callback registered with
62 /// part of the RabbitMQ .NET client library, it is caught,
63 /// packaged into a CallbackExceptionEventArgs, and passed through
64 /// the appropriate IModel's or IConnection's CallbackException
65 /// event handlers. If an exception is thrown in a
66 /// CallbackException handler, it is silently swallowed, as
67 /// CallbackException is the last chance to handle these kinds of
71 /// Code constructing CallbackExceptionEventArgs instances will
72 /// usually place helpful information about the context of the
73 /// call in the IDictionary available through the Detail property.
76 public class CallbackExceptionEventArgs: EventArgs
78 private IDictionary m_detail;
79 private Exception m_exception;
81 ///<summary>Wrap an exception thrown by a callback.</summary>
82 public CallbackExceptionEventArgs(Exception exception)
84 m_detail = new Hashtable();
85 m_exception = exception;
88 ///<summary>Access helpful information about the context in
89 ///which the wrapped exception was thrown.</summary>
90 public IDictionary Detail { get { return m_detail; } }
92 ///<summary>Access the wrapped exception.</summary>
93 public Exception Exception { get { return m_exception; } }