This documentation is archived and is not being maintained.

AppDomain.Load Method (AssemblyName)

.NET Framework 1.1

Loads an Assembly given its AssemblyName.

[Visual Basic]
Overloads Public Overridable Function Load( _
   ByVal assemblyRef As AssemblyName _
) As Assembly Implements _AppDomain.Load
[C#]
public virtual Assembly Load(
 AssemblyName assemblyRef
);
[C++]
public: virtual Assembly* Load(
 AssemblyName* assemblyRef
);
[JScript]
public function Load(
   assemblyRef : AssemblyName
) : Assembly;

Parameters

assemblyRef
An object that describes the assembly to load.

Return Value

The loaded assembly.

Implements

_AppDomain.Load

Exceptions

Exception Type Condition
ArgumentNullException assemblyRef is a null reference (Nothing in Visual Basic).
FileNotFoundException assemblyRef is not found.
BadImageFormatException assemblyRef is not a valid assembly.
AppDomainUnloadedException Operations are attempted on an unloaded application domain.
SecurityException The caller does not have the correct permissions. See the requirements section.

Remarks

This method should only be used to load an assembly into the current application domain. This method is defined for interoperability callers who cannot call the static Load method.

An attempt to call Load on a target application domain that is not the current application domain will result in a successful load of the assembly in the target application domain. Since an Assembly is not MarshalByRefObject, when this method attempts to return the Assembly for the loaded assembly to the current application domain, the common language runtime will try to load the assembly into the current application domain and the load might fail. The assembly that is loaded into the current application domain might be different from the assembly that was loaded first if the path settings for the two application domains are different.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

.NET Framework Security: 

See Also

AppDomain Class | AppDomain Members | System Namespace | AppDomain.Load Overload List

Show: