AppDomain.ReflectionOnlyGetAssemblies Method

Definition

Returns the assemblies that have been loaded into the reflection-only context of the application domain.

C#
public System.Reflection.Assembly[] ReflectionOnlyGetAssemblies();

Returns

An array of Assembly objects that represent the assemblies loaded into the reflection-only context of the application domain.

Exceptions

An operation is attempted on an unloaded application domain.

Examples

The following code example loads the System.dll assembly into the execution context and then into the reflection-only context. The GetAssemblies and ReflectionOnlyGetAssemblies methods are used to display the assemblies loaded into each context.

C#
using System;
using System.Reflection;
using System.Timers;

public class ReflectionOnlySnippet
{
    public static void Main()
    {
        // Get the assembly display name for System.dll, the assembly
        // that contains System.Timers.Timer. Note that this causes
        // System.dll to be loaded into the execution context.
        //
        string displayName = typeof(Timer).Assembly.FullName;

        // Load System.dll into the reflection-only context. Note that
        // if you obtain the display name (for example, by running this
        // example program), and enter it as a literal string in the
        // preceding line of code, you can load System.dll into the
        // reflection-only context without loading it into the execution
        // context.
        Assembly.ReflectionOnlyLoad(displayName);

        // Display the assemblies loaded into the execution and
        // reflection-only contexts. System.dll appears in both contexts.
        //
        Console.WriteLine("------------- Execution Context --------------");
        foreach (Assembly a in AppDomain.CurrentDomain.GetAssemblies())
        {
            Console.WriteLine("\t{0}", a.GetName());
        }
        Console.WriteLine("------------- Reflection-only Context --------------");
        foreach (Assembly a in AppDomain.CurrentDomain.ReflectionOnlyGetAssemblies())
        {
            Console.WriteLine("\t{0}", a.GetName());
        }
    }
}

Remarks

This method returns the assemblies that have been loaded into the reflection-only context. To get the assemblies that have been loaded for execution, use the GetAssemblies method.

Applies to

Product Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

See also