This documentation is archived and is not being maintained.

Assembly.ReflectionOnlyLoad Method (String)

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

Namespace: System.Reflection
Assembly: mscorlib (in mscorlib.dll)

Public Shared Function ReflectionOnlyLoad ( _
	assemblyString As String _
) As Assembly
Dim assemblyString As String
Dim returnValue As Assembly

returnValue = Assembly.ReflectionOnlyLoad(assemblyString)
public static Assembly ReflectionOnlyLoad (
	String assemblyString
public static function ReflectionOnlyLoad (
	assemblyString : String
) : Assembly
Not applicable.



The display name of the assembly, as returned by the AssemblyName.FullName property.

Return Value

An Assembly object that represents the loaded assembly.

Exception typeCondition


assemblyString is a null reference (Nothing in Visual Basic).


assemblyString is an empty string ("").


assemblyString is not found.


assemblyString is found, but cannot be loaded.


assemblyString is not a valid assembly.


Version 2.0 or later of the common language runtime is currently loaded and assemblyString was compiled with a later version.

Dependencies are not automatically loaded into the reflection-only context.

You cannot execute code from an assembly loaded into the reflection-only context. To execute code, the assembly must be loaded into the execution context as well, using the Load method.

Whether certain permissions are granted or not granted to an assembly is based on evidence. The rules for assembly and security evidence merging are as follows:


Reflecting on executable files compiled in C++ might throw a FileLoadException. This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. To preserve the .reloc address, specify /fixed:no when you are linking.

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.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0