MutationException.cs

using System;
using System.Runtime.Serialization;

namespace GeneticSharp
{
    /// <summary>
    /// Exception throw when an error occurs during the execution of mutate.
    /// </summary>
    [Serializable]
    public sealed class MutationException : Exception
    {
        #region Constructors
        /// <summary>
        /// Initializes a new instance of the <see cref="GeneticSharp.MutationException"/> class.
        /// </summary>
        /// <param name="mutation">The mutation where occurred the error.</param>
        /// <param name="message">The error message.</param>
        public MutationException(IMutation mutation, string message)
            : base("{0}: {1}".With(mutation != null ? mutation.GetType().Name : String.Empty, message))
        {
            Mutation = mutation;
        }

        /// <summary>
        /// Initializes a new instance of the <see cref="GeneticSharp.MutationException"/> class.
        /// </summary>
        /// <param name="mutation">The Mutation where occurred the error.</param>
        /// <param name="message">The error message.</param>
        /// <param name="innerException">The inner exception.</param>
        public MutationException(IMutation mutation, string message, Exception innerException)
            : base("{0}: {1}".With(mutation != null ? mutation.GetType().Name : String.Empty, message), innerException)
        {
            Mutation = mutation;
        }

        /// <summary>
        /// Initializes a new instance of the <see cref="MutationException"/> class.
        /// </summary>
        public MutationException()
        {
        }

        /// <summary>
        /// Initializes a new instance of the <see cref="MutationException"/> class.
        /// </summary>
        /// <param name="message">The message that describes the error.</param>
        public MutationException(string message)
            : base(message)
        {
        }

        /// <summary>
        /// Initializes a new instance of the <see cref="MutationException"/> class.
        /// </summary>
        /// <param name="message">The error message that explains the reason for the exception.</param>
        /// <param name="innerException">The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.</param>
        public MutationException(string message, Exception innerException)
            : base(message, innerException)
        {
        }

        /// <summary>
        /// Initializes a new instance of the <see cref="MutationException"/> class.
        /// </summary>
        /// <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that holds the serialized object data about the exception being thrown.</param>
        /// <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext" /> that contains contextual information about the source or destination.</param>
        private MutationException(SerializationInfo info, StreamingContext context)
            : base(info, context)
        {
        }
        #endregion

        #region Properties
        /// <summary>
        /// Gets the mutation.
        /// </summary>
        /// <value>The mutation.</value>
        public IMutation Mutation { get; private set; }
        #endregion

        #region Methods
        /// <summary>
        /// Sets the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> with information about the exception.
        /// </summary>
        /// <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that holds the serialized object data about the exception being thrown.</param>
        /// <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext" /> that contains contextual information about the source or destination.</param>               
        public override void GetObjectData(SerializationInfo info, StreamingContext context)
        {
            base.GetObjectData(info, context);
            info.AddValue("Mutation", Mutation);
        }
        #endregion
    }
}