CSTypes 1.0.5

CSTypes

C# Types Argument Parser

	Description
CREATED BY:	Latency McLaughlin
UPDATED:	4/11/2024
FRAMEWORK:	[netstandard2.1], [netstandard2.0], [net452] ([Latest])
LANGUAGE:	[C#] preview
OUTPUT TYPE:	Library [API]
SUPPORTS:	[Visual Studio]
GFX SUBSYS:	[None]
TAGS:	[ArgInterpreter], CSTypes, [C#]
STATUS
LICENSE:
VERSION:

<hr>

Navigation

• <a href="#introduction">Introduction</a>
• <a href="#history">History</a>
• <a href="#solution">Solution</a>
• <a href="#usage">Usage</a>
• <a href="#installation">Installation</a>
• <a href="#license">License</a>

<hr>

<h2><a name="introduction">Introduction</a></h2>

Gets assembly information at runtime commonly found in Properties within .NET assemblies. Dynamically loads / unloads assemblies and their dependencies within a proxy for validation.

<h2><a name=history">History</a></h2>

Trying to get information out of an assembly without loading it into the current application domain is not that simple. There is no way to get custom assembly attributes without loading it into the current AppDomain. There is a special assembly loading method, <i>Assembly.ReflectionOnlyLoad()</i>, which uses a "reflection-only" load context. This lets you load assemblies that cannot be executed, but can have their metadata read. You cannot get typed attributes from this kind of assembly, only CustomAttributeData. That class doesn't provide any good way to filter for a specific attribute.

Even worse, a reflection-only load does not load any dependency assemblies, but it forces you to do it manually. That makes it objectively worse than <i>Assembly.Load()</i> which at least gets the dependencies to load automatically.

MEF includes a whole ton of custom reflection code to make this work.

Ultimately, you cannot unload an assembly once it has been loaded. You need to unload the entire app domain, as described in this MSDN article.

<h2><a name="solution">Solution</a></h2>

Based on the following premises:

Creating an assembly proxy (or wrapper), derived from MarshalByRefObject, so that the CLR can marshal it by reference across AppDomain boundaries. Loading the assembly within this proxy. Performing the reflection inside this proxy and return the data you need. Creating a temporary AppDomain and instantiating the assembly proxy in this AppDomain (AppDomain.CreateInstanceFrom). Unloading the AppDomain as soon as you finished reflecting.

However, you have to keep in mind that reflection on the assembly loaded this way is only possible inside the proxy (the one derived from MarshalByRefObject). It is not possible to return any "reflection object" (anything defined in the System.Reflection namespace, such as Type, MethodInfo, etc.). Trying to access these from another AppDomain (the caller's domain) would result in exceptions.

<h2><a name="usage">Usage</a></h2>

• Types called across AppDomain boundaries must inherit MarshalByRefObject.
• Types called across AppDomain boundaries must be called via an interface.
• The property LoaderOptimization must be set to LoaderOptimization.MultiDomainHost.
• Construct a proxy manager that loads assemblies into AppDomains, performs queries, and unloads AppDomains.

<h2><a name="installation">Installation</a></h2>

This library can be installed using NuGet found here.

<h2><a name="license">License</a></h2>

The source code for the site is licensed under the MIT license, which you can find in the MIT-LICENSE.txt file.

All graphical assets are licensed under the Creative Commons Attribution 3.0 Unported License.