Oakrey.Reflection 2.1.0

Oakrey.Reflection

Oakrey.Reflection provides focused helpers for common .NET reflection tasks: loading assemblies, working with enums, finding implementors, creating instances, clearing event handlers, and setting properties dynamically.

Features

• AppDomainExtensions loads assemblies from the current application directory or a selected directory and skips assemblies that are already loaded.
• Enums reads enum descriptions, enumerates values, converts enums by name or value, and exposes non-throwing conversion helpers.
• Events clears typed event delegates and removes field-like event handlers from an object, including inherited events.
• PropertyReflection sets public properties dynamically with invariant-culture conversion, enum parsing, nullable support, and optional case-insensitive lookup.
• TypeExtensions finds concrete implementors, caches allow-list searches safely, creates instances, and provides a TryCreateInstanceOfBase helper.

Installation

dotnet add package Oakrey.Reflection

Package Manager Console:

Install-Package Oakrey.Reflection

Examples

Set a property dynamically:

Soldier soldier = new();

bool changed = soldier.TrySetProperty("Rank", "Major");
bool changedCaseInsensitive = soldier.TrySetProperty("rank", "General", ignoreCase: true);

Convert enum values safely:

if (sourceRank.TryConvertByNameTo<TargetRank>(out TargetRank targetRank))
{
    Console.WriteLine(targetRank);
}

Find implementors in selected assemblies:

List<Type> commands = typeof(ICommand).GetImplementors(["MyCompany.MyApp"]);

Create an instance without throwing:

if (typeof(MyService).TryCreateInstanceOfBase<IMyService>(out IMyService? service))
{
    service.Run();
}

Clear field-like event subscriptions:

publisher.UnsubscribeAllEventHandlers();

Notes

• Reflection can bypass normal compile-time guarantees. TrySetProperty therefore rejects null for non-nullable properties when nullable metadata is available.
• GetImplementors(type, allowList) filters by assembly full name and returns a defensive copy of cached results.
• LoadAssemblies catches common load failures such as BadImageFormatException, FileLoadException, and FileNotFoundException and writes diagnostics to trace output.

Requirements

• .NET 10 or higher

Project Information

• Author: Oakrey
• Company: Oakrey (Website)
• License: MIT
• Repository: Git Repository
• Project URL: NuGet