DMNSN.Extensions 8.0.1

DMNSN Extensions

DMNSN Extensions is a C# library that provides extension methods for working with enums and exceptions. This library aims to simplify common tasks and improve code readability.

Table of Contents

• DMNSN Extensions
  • Table of Contents
  • Installation
  • Usage
    • Enum Extensions
      • Methods
      • Example
    • Exception Extensions
      • Methods
      • Example
  • License

Installation

You can install DMNSN Extensions via NuGet Package Manager:

Install-Package DMNSN.Extensions

Usage

Enum Extensions

The EnumExtensions class provides extension methods for working with enums. It is located in src/EnumExtensions.cs.

Methods

• ToInt<T>(this T source) where T : Enum
  • Converts the enum value to its corresponding integer representation.
  • Parameters:
    • source: The enum value to convert.
  • Returns: The integer representation of the enum value.
• GetDescription<T>(this T source) where T : Enum
  • Gets the description attribute value of the enum value.
  • Parameters:
    • source: The enum value.
  • Returns: The description attribute value of the enum value.

Example

using DMNSN.Extensions;

public enum SampleEnum
{
    [Description("Sample Description")]
    SampleValue
}

var value = SampleEnum.SampleValue;
int intValue = value.ToInt();
string description = value.GetDescription();

Exception Extensions

The ExceptionExtensions class provides extension methods for the Exception class. It is located in src/ExceptionExtensions.cs.

Methods

• GetMessage(this Exception ex, bool getInner = true, string inSeparator = INNER_EX_SEPARATOR)
  • Gets the message of the exception and its inner exceptions recursively.
  • Parameters:
    • ex: The exception.
    • getInner: Flag indicating whether to include inner exceptions.
    • inSeparator: Separator string between the exception messages.
    • Returns: The concatenated message of the exception and its inner exceptions.
• GetMessageUrlEncoded(this Exception ex, bool getInner = true, string inSeparator = INNER_EX_SEPARATOR)
  • Gets the URL-encoded message of the exception and its inner exceptions recursively.
  • Parameters:
    • ex: The exception.
    • getInner: Flag indicating whether to include inner exceptions.
    • inSeparator: Separator string between the exception messages.
    • Returns: The URL-encoded concatenated message of the exception and its inner exceptions.

Example

using DMNSN.Extensions;

try
{
    // Some code that throws an exception
}
catch (Exception ex)
{
    string message = ex.GetMessage();
    string urlEncodedMessage = ex.GetMessageUrlEncoded();
}

License

his project is licensed under the MIT License - see the LICENSE file for details.