AppDomain.ReflectionOnlyAssemblyResolve Event

Definition

Occurs when the resolution of an assembly fails in the reflection-only context.

public event ResolveEventHandler? ReflectionOnlyAssemblyResolve;
public event ResolveEventHandler ReflectionOnlyAssemblyResolve;
[add: System.Security.SecurityCritical]
[remove: System.Security.SecurityCritical]
public event ResolveEventHandler ReflectionOnlyAssemblyResolve;

Event Type

Attributes

Remarks

In the reflection-only context, dependencies are not resolved automatically. They must be preloaded or returned by the handler for this event. This event is raised when an assembly has a dependency that is not already loaded into the reflection-only context. The missing dependency is specified by the ResolveEventArgs.Name property. The ResolveEventHandler for this event must return an assembly that satisfies the dependency. The assembly that is returned must be loaded into the reflection-only context.

Important

This event is raised only for missing dependencies of the assembly that you are loading into the reflection-only context (for example, by using the Assembly.ReflectionOnlyLoad method). It is not raised if the assembly that you are loading cannot be found.

Beginning with the .NET Framework 4, the ResolveEventArgs.RequestingAssembly property returns the assembly that requested the assembly load that could not be resolved. Knowing the identity of the requesting assembly might be useful in identifying the correct version of the dependency, if more than one version is available. For more information, see ResolveEventArgs.RequestingAssembly.

For this event, the ResolveEventArgs.Name property returns the assembly name before policy is applied.

For more information about handling events, see Handling and Raising Events.

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