Class ApplicationException

The exception that is thrown when a non-fatal application error occurs.

Inheritance
Object
Exception
System.ApplicationException
ApplicationException
DataApplicationException
Inherited Members
System.Exception.GetBaseException()
System.Exception.ToString()
System.Exception.GetType()
System.Exception.Message
System.Exception.Data
System.Exception.TargetSite
System.Exception.StackTrace
System.Exception.Source
System.Exception.SerializeObjectState
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
Namespace: IRM
Assembly: IRM.dll
Syntax
[Serializable]
public class ApplicationException : ApplicationException, ISerializable, _Exception

Constructors

ApplicationException()

Initializes a new instance of the ApplicationException class.

Declaration
public ApplicationException()

ApplicationException(SerializationInfo, StreamingContext)

Initializes a new instance of the ApplicationException class with serialized data.

Declaration
protected ApplicationException(SerializationInfo info, StreamingContext context)
Parameters
SerializationInfo info

The object that holds the serialized object data.
StreamingContext context

The contextual information about the source or destination.
Remarks

This constructor is called during deserialization to reconstitute the exception object transmitted over a stream.

ApplicationException(String)

Initializes a new instance of the ApplicationException class with a specified error message.

Declaration
public ApplicationException(string message)
Parameters
String message

The error message that explains the reason for the exception.
Remarks

The content of the message parameter is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.

ApplicationException(String, Exception)

Initializes a new instance of the ApplicationException class with a specified error message and a reference to the inner exception that is the cause of this exception.

Declaration
public ApplicationException(string message, Exception innerException)
Parameters
String message

The error message that explains the reason for the exception.
Exception innerException

The exception that is the cause of the current exception. If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.
Remarks

The content of the message parameter is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.

An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. The InnerException property returns the same value that is passed into the constructor, or a null reference if the InnerException property does not supply the inner exception value to the constructor.

Properties

AdditionalInformation

Collection allowing additional information to be added to the exception.

Declaration
public NameValueCollection AdditionalInformation { get; }
Property Value
System.Collections.Specialized.NameValueCollection

CorrelationId

Gets a correlation id that can be used to correlate different actions that is going on in a system.

Declaration
public Guid CorrelationId { get; set; }
Property Value
System.Guid

CreatedDateTime

Gets the date and time when the exception was created.

Declaration
public DateTime CreatedDateTime { get; }
Property Value
System.DateTime

HandlingInstanceId

Gets or sets the identifier used when logging the exception on the server.

Declaration
[Obsolete("Use CorrelationId instead.")]
public Guid HandlingInstanceId { get; set; }
Property Value
System.Guid

Remarks

This property will only be set if the server has handled the exception in this way.

MachineName

Gets the name of the machine where the exception occurred.

Declaration
public string MachineName { get; }
Property Value
String

ThreadIdentityName

Gets the identity of the executing thread on which the exception was created.

Declaration
public string ThreadIdentityName { get; }
Property Value
String

WindowsIdentityName

Gets the windows identity under which the code was running when the exception occured.

Declaration
public string WindowsIdentityName { get; }
Property Value
String

Methods

GetObjectData(SerializationInfo, StreamingContext)

When overridden in a derived class, sets the SerializationInfo with information about the exception.

Declaration
[SecurityPermission(SecurityAction.Demand, SerializationFormatter = true)]
public override void GetObjectData(SerializationInfo info, StreamingContext context)
Parameters
SerializationInfo info

The object that holds the serialized object data.
StreamingContext context

The contextual information about the source or destination.
Overrides
Remarks

GetObjectData sets a SerializationInfo with all the exception object data targeted for serialization. During deserialization, the exception is reconstituted from the SerializationInfo transmitted over the stream.

Extension Methods