Loads an assembly given its System.Reflection.AssemblyName.
Syntax
Parameters
- assemblyRef
Returns
The loaded assembly.
Remarks
System.IO.FileLoadException is thrown if assemblyRef specifies the full assembly name and the first assembly that matches the simple name has a different version, culture, or public key token. The loader does not continue probing for other assemblies that match the simple name.
Do not use an System.Reflection.AssemblyName with only the AssemblyName.CodeBase property set. The AssemblyName.CodeBase property does not supply any elements of the assembly identity (such as name or version), so loading does not occur according to load-by-identity rules, as you would expect from the Assembly.Load(AssemblyName) method. Instead, the assembly is loaded using load-from rules. For information about the disadvantages of using the load-from context, see the Assembly.LoadFrom(string) method overload or Best Practices for Assembly Loading.
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 Assembly.Load(string) method with no System.Security.Policy.Evidence parameter, the assembly is loaded with the evidence that the loader supplies.
When you use a Assembly.Load(string) method with an System.Security.Policy.Evidence parameter, pieces of evidence are merged. Pieces of evidence supplied as an argument to the Assembly.Load(string) method supersede pieces of evidence supplied by the loader.
When you use a Assembly.Load(string) method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.
When you use a Assembly.Load(string) method with a Byte[] parameter and System.Security.Policy.Evidence to load a 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 the 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 both the AssemblyName.Name property and the AssemblyName.CodeBase property are set, the first attempt to load the assembly uses the display name (including version, culture, and so on, as returned by the Assembly.FullName property). If the file is not found, AssemblyName.CodeBase is used to search for the assembly. If the assembly is found using AssemblyName.CodeBase, the display name is matched against the assembly. If the match fails, a System.IO.FileLoadException is thrown.
Requirements
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0