This topic has not yet been rated - Rate this topic

Assembly.LoadWithPartialName Method (String, Evidence)

.NET Framework 4

Updated: July 2010

Note: This API is now obsolete. The non-obsolete alternative is Load().

Loads an assembly from the application directory or from the global assembly cache using a partial name. The assembly is loaded into the domain of the caller using the supplied evidence.

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

Syntax

C++

Copy

[ObsoleteAttribute("This method has been deprecated. Please use Assembly.Load() instead. http://go.microsoft.com/fwlink/?linkid=14202")]
public static Assembly LoadWithPartialName(
	string partialName,
	Evidence securityEvidence
)

Parameters

partialName: Type: System.String
The display name of the assembly.

securityEvidence: Type: System.Security.Policy.Evidence
Evidence for loading the assembly.

Return Value

Type: System.Reflection.Assembly
The loaded assembly. If partialName is not found, this method returns null.

Exceptions

Exception	Condition
FileLoadException	An assembly or module was loaded twice with two different sets of evidence.
ArgumentNullException	The partialName parameter is null.
BadImageFormatException	assemblyFile is not a valid assembly. -or- Version 2.0 or later of the common language runtime is currently loaded and partialName was compiled with a later version.

Exception

Condition

FileLoadException

An assembly or module was loaded twice with two different sets of evidence.

ArgumentNullException

The partialName parameter is null.

BadImageFormatException

assemblyFile is not a valid assembly.

-or-

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

Remarks

Evidence is the set of information that constitutes input to security policy decisions, such as what permissions can be granted to code.

Applications that load assemblies with this method will be affected by upgrades of those assemblies. Therefore, do not use this method; redesign the application to use the Load method or the LoadFrom method.

This method first calls Load. If the assembly is not found, this method returns the assembly from the global assembly cache that has the same simple name, and the highest version number.

Version Information

.NET Framework

Supported in: 1.1, 1.0
Obsolete (compiler warning) in 4
Obsolete (compiler warning) in 3.5
Obsolete (compiler warning) in 3.5 SP1
Obsolete (compiler warning) in 3.0
Obsolete (compiler warning) in 3.0 SP1
Obsolete (compiler warning) in 3.0 SP2
Obsolete (compiler warning) in 2.0
Obsolete (compiler warning) in 2.0 SP1
Obsolete (compiler warning) in 2.0 SP2

.NET Framework Client Profile

Obsolete (compiler warning) in 4
Obsolete (compiler warning) in 3.5 SP1

.NET Framework Security

SecurityPermission
for calling unmanaged code and to load an assembly with evidence. Associated enumeration: SecurityPermissionFlag.ControlEvidence

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.