Assembly.ReflectionOnlyLoadFrom(String) Method

Definition

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);
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}")]
public static System.Reflection.Assembly ReflectionOnlyLoadFrom (string assemblyFile);
static member ReflectionOnlyLoadFrom : string -> System.Reflection.Assembly
[<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

The loaded assembly.

Attributes

Exceptions

assemblyFile is null.

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

assemblyFile is found, but could not be loaded.

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

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

The assembly name exceeds the system-defined maximum length.

assemblyFile is an empty string ("").

.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.

Applies to