Assembly.ReflectionOnlyLoadFrom(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.AssemblyPublic Shared Function ReflectionOnlyLoadFrom (assemblyFile As String) As AssemblyParameters
- 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.
