Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Assembly.Load Method (String, Evidence)

Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.

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

public static Assembly Load (
	string assemblyString,
	Evidence assemblySecurity
)
public static Assembly Load (
	String assemblyString, 
	Evidence assemblySecurity
)
public static function Load (
	assemblyString : String, 
	assemblySecurity : Evidence
) : Assembly

Parameters

assemblyString

The display name of the assembly.

assemblySecurity

Evidence for loading the assembly.

Return Value

The loaded assembly.

Exception typeCondition

ArgumentNullException

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

FileNotFoundException

assemblyString is not found.

BadImageFormatException

assemblyString is not a valid assembly.

FileLoadException

A file that was found could not be loaded.

-or-

An assembly or module was loaded twice with two different evidences.

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:

  • When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • When you use a Load method with an Evidence parameter, pieces of evidence are merged. Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • When you use a Load method with a Byte[] parameter to load a common object file format (COFF) image, evidence is combined. Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • When you use a Load method with a Byte[] parameter and Evidence to load a common object file format (COFF) image, only the supplied evidence is used. Evidence of the calling assembly and evidence of the COFF image is ignored.

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

If you call this method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. The evidence that first succeeds is the evidence that is used.

Windows 98, Windows 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2015 Microsoft