Assembly.ReflectionOnlyLoadFrom(String) Method

Definition

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Source:

Assembly.cs

Caution

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Loads an assembly into the reflection-only context, given its path.

public:
 static System::Reflection::Assembly ^ ReflectionOnlyLoadFrom(System::String ^ assemblyFile);

[System.Obsolete("ReflectionOnly loading is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0018", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Reflection.Assembly ReflectionOnlyLoadFrom (string assemblyFile);

[<System.Obsolete("ReflectionOnly loading is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0018", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member ReflectionOnlyLoadFrom : string -> System.Reflection.Assembly

Public Shared Function ReflectionOnlyLoadFrom (assemblyFile As String) As Assembly

Parameters

assemblyFile

String

The path of the file that contains the manifest of the assembly.

Returns

Assembly

The loaded assembly.

Attributes

ObsoleteAttribute

Exceptions

ArgumentNullException

assemblyFile is null.

FileNotFoundException

assemblyFile is not found, or the module you are trying to load does not specify a file name extension.

FileLoadException

assemblyFile is found, but could not be loaded.

BadImageFormatException

assemblyFile is not a valid assembly for the currently loaded runtime.

SecurityException

A codebase that does not start with "file://" was specified without the required WebPermission.

PathTooLongException

The assembly name exceeds the system-defined maximum length.

ArgumentException

assemblyFile is an empty string ("").

PlatformNotSupportedException

.NET Core and .NET 5+ only: In all cases.

Remarks

Dependencies are not automatically loaded into the reflection-only context. To automatically load dependencies, handle the ReflectionOnlyAssemblyResolve event and load the dependency in the event handler.

You cannot execute code from an assembly that has been loaded into the reflection-only context. To execute the code, load the assembly with the LoadFile method.

The assemblyFile parameter must refer to a URI without escape characters. This method supplies escape characters for all invalid characters in the URI.

The path specified for assemblyFile is relative to the current directory.

The reflection-only context is no different from other contexts. Assemblies that are loaded into the context can be unloaded only by unloading the application domain.