Represents an exception. Never create instances of this class manually. Use the Exception class instead. Never wrap the Exception class instances into System::SmartPtr. More...

#include <exception.h>

Inherits System::Object.

Inherited by Aspose::Zip::Details_ZipException, Aspose::Zip::Details_ZlibException, System::Net::Http::Details_HttpRequestException, System::Net::Sockets::Details_SocketException, System::Reflection::Details_ReflectionTypeLoadException, and System::Web::Details_HttpException.

Public Member Functions
virtual String	get_Message () const
	Returns the string containing the error destcription. More...

virtual String	get_StackTrace () const
	Returns the string containing the stack trace. More...

virtual ExceptionWrapper< Details_Exception >	get_InnerException () const
	Returns a reference to the object representing the inner exception. More...

virtual ExceptionWrapper< Details_Exception >	GetBaseException () const
	Returns the copy of Exception object representing the inner-most exception. More...

int32_t	get_HResult () const
	Returns a 32-bit integer value which is a HRESULT code associated with the exception reprsented by the current object. More...

void	set_HResult (int32_t value)
	Sets HRESULT, a coded numerical value that is assigned to a specific exception. More...

virtual String	ToString () const override
	Returns the string representation of the current object. More...

virtual const char *	what () const noexcept
	Implements what() method which is called by ExceptionWrapper class. Despite of the fact that this class is not inherited from std::exception derived classes can use protected/private members to implement their logic. Moving this method implementation to the ExceptionWrapper may broke that logic. More...

virtual void	DoThrow (const ExceptionPtr &self) const
	Throws exception instance wrapped by exception wrapper. More...

Public Member Functions inherited from System::Object
	Object ()
	Creates object. Initializes all internal data structures. More...

virtual	~Object ()
	Destroys object. Frees all internal data structures. More...

	Object (Object const &x)
	Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...

Object &	operator= (Object const &x)
	Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...

Object *	SharedRefAdded ()
	Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

int	SharedRefRemovedSafe ()
	Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

int	RemovedSharedRefs (int count)
	Decreases shared reference count by specified value. More...

Detail::SmartPtrCounter *	WeakRefAdded ()
	Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

void	WeakRefRemoved ()
	Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

Detail::SmartPtrCounter *	GetCounter ()
	Gets reference counter data structure associated with the object. More...

int	SharedCount () const
	Gets current value of shared reference counter. More...

void	Lock ()
	Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...

void	Unlock ()
	Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...

virtual bool	Equals (ptr obj)
	Compares objects using C# Object.Equals semantics. More...

virtual int32_t	GetHashCode () const
	Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...

virtual String	ToString () const
	Analog of C# Object.ToString() method. Enables converting custom objects to string. More...

virtual ptr	MemberwiseClone () const
	Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...

virtual const TypeInfo &	GetType () const
	Gets actual type of object. Analog of C# System.Object.GetType() call. More...

virtual bool	Is (const TypeInfo &targetType) const
	Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...

virtual void	SetTemplateWeakPtr (uint32_t argument)
	Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...

virtual bool	FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
	For internal purposes only. More...

template<>
bool	ReferenceEquals (String const &str, std::nullptr_t)
	Specialization of Object::ReferenceEquals for case of string and nullptr. More...

template<>
bool	ReferenceEquals (String const &str1, String const &str2)
	Specialization of Object::ReferenceEquals for case of strings. More...

Protected Member Functions
	Details_Exception ()
	Constructs an instance of Exception class. More...

	Details_Exception (const String &message)
	Constructs an instance of Exception class and assigns the specified error message to it. More...

	Details_Exception (const String &message, const ExceptionWrapper< Details_Exception > &innerException)
	Constructs an instance of Exception class and assigns the specified error message and a reference to the inner exception object. More...

	Details_Exception (const System::SharedPtr< System::Runtime::Serialization::SerializationInfo > &info, System::Runtime::Serialization::StreamingContext context)
	Deserializes exception. More...

virtual String	ExtraDescription () const
	Returns a string containing additional description of the exception. More...

String	DefaultMessage () const
	Returns a default description of the exception based on type. More...

Protected Attributes
String	m_message
	The error description. More...

System::ExceptionWrapper< Details_Exception >	m_innerexception
	The Exception object representing the inner exception. More...

std::string	m_std_message
	A string describing the std::exception portion of the current object. More...

int32_t	m_HResult
	HRESULT code associated with the exception represented by the current object. More...

Additional Inherited Members
Public Types inherited from System::Object
typedef SmartPtr< Object >	ptr
	Alias for smart pointer type. More...

Static Public Member Functions inherited from System::Object
static bool	ReferenceEquals (ptr const &objA, ptr const &objB)
	Compares objects by reference. More...

template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type	ReferenceEquals (T const &objA, T const &objB)
	Compares objects by reference. More...

template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type	ReferenceEquals (T const &objA, std::nullptr_t)
	Reference-compares value type object with nullptr. More...

template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type	Equals (T1 const &objA, T2 const &objB)
	Compares reference type objects in C# style. More...

template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type	Equals (T1 const &objA, T2 const &objB)
	Compares value type objects in C# style. More...

static const TypeInfo &	Type ()
	Implements C# typeof(System.Object) construct. More...

template<>
bool	Equals (float const &objA, float const &objB)
	Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...

template<>
bool	Equals (double const &objA, double const &objB)
	Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...

Detailed Description

Represents an exception. Never create instances of this class manually. Use the Exception class instead. Never wrap the Exception class instances into System::SmartPtr.

Constructor & Destructor Documentation

◆ Details_Exception() [1/4]

System::Details_Exception::Details_Exception ( )

protected

Constructs an instance of Exception class.

◆ Details_Exception() [2/4]

System::Details_Exception::Details_Exception ( const String & message )

protected

Constructs an instance of Exception class and assigns the specified error message to it.

Parameters

message String that contains the error destription

◆ Details_Exception() [3/4]

System::Details_Exception::Details_Exception	(	const String &	message,
		const ExceptionWrapper< Details_Exception > &	innerException
	)

protected

Constructs an instance of Exception class and assigns the specified error message and a reference to the inner exception object.

Parameters

message	String that contains the error destription
innerException	A reference to the exception object interpreted as a cause for the exception represented by the Exception being constructed

◆ Details_Exception() [4/4]

System::Details_Exception::Details_Exception	(	const System::SharedPtr< System::Runtime::Serialization::SerializationInfo > &	info,
		System::Runtime::Serialization::StreamingContext	context
	)

protected

Deserializes exception.

Parameters

info	SerializationInfo object holding serialized exception.
context	Streaming context bound to serialization info passed.

Member Function Documentation

◆ DefaultMessage()

String System::Details_Exception::DefaultMessage ( ) const

protected

Returns a default description of the exception based on type.

◆ DoThrow()

virtual void System::Details_Exception::DoThrow ( const ExceptionPtr & self ) const

virtual

Throws exception instance wrapped by exception wrapper.

Parameters

self	Exception instance to be thrown.

Reimplemented in System::Net::Sockets::Details_SocketException, System::Web::Details_HttpException, and System::Reflection::Details_ReflectionTypeLoadException.

◆ ExtraDescription()

virtual String System::Details_Exception::ExtraDescription ( ) const

protectedvirtual

Returns a string containing additional description of the exception.

◆ get_HResult()

int32_t System::Details_Exception::get_HResult ( ) const

Returns a 32-bit integer value which is a HRESULT code associated with the exception reprsented by the current object.

◆ get_InnerException()

virtual ExceptionWrapper< Details_Exception > System::Details_Exception::get_InnerException ( ) const

virtual

Returns a reference to the object representing the inner exception.

◆ get_Message()

virtual String System::Details_Exception::get_Message ( ) const

virtual

Returns the string containing the error destcription.

◆ get_StackTrace()

virtual String System::Details_Exception::get_StackTrace ( ) const

virtual

Returns the string containing the stack trace.

◆ GetBaseException()

virtual ExceptionWrapper< Details_Exception > System::Details_Exception::GetBaseException ( ) const

virtual

Returns the copy of Exception object representing the inner-most exception.

◆ set_HResult()

void System::Details_Exception::set_HResult ( int32_t value )

Sets HRESULT, a coded numerical value that is assigned to a specific exception.

◆ ToString()

virtual String System::Details_Exception::ToString ( ) const

overridevirtual

Returns the string representation of the current object.

Reimplemented from System::Object.

◆ what()

virtual const char * System::Details_Exception::what ( ) const

virtualnoexcept

Implements what() method which is called by ExceptionWrapper class. Despite of the fact that this class is not inherited from std::exception derived classes can use protected/private members to implement their logic. Moving this method implementation to the ExceptionWrapper may broke that logic.

Returns: The description of the exception.

Member Data Documentation

◆ m_HResult

int32_t System::Details_Exception::m_HResult

mutableprotected

HRESULT code associated with the exception represented by the current object.

◆ m_innerexception

System::ExceptionWrapper<Details_Exception> System::Details_Exception::m_innerexception

protected

The Exception object representing the inner exception.

◆ m_message

String System::Details_Exception::m_message

protected

The error description.

◆ m_std_message

std::string System::Details_Exception::m_std_message

mutableprotected

A string describing the std::exception portion of the current object.

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Details_Exception() [1/4]

◆ Details_Exception() [2/4]

◆ Details_Exception() [3/4]

◆ Details_Exception() [4/4]

Member Function Documentation

◆ DefaultMessage()

◆ DoThrow()

◆ ExtraDescription()

◆ get_HResult()

◆ get_InnerException()

◆ get_Message()

◆ get_StackTrace()

◆ GetBaseException()

◆ set_HResult()

◆ ToString()

◆ what()

Member Data Documentation

◆ m_HResult

◆ m_innerexception

◆ m_message

◆ m_std_message