AppDomain.ExecuteAssemblyByName Method (String, Evidence, String[]) (System)

.NET Framework Class Library

AppDomain..::.ExecuteAssemblyByName Method (String, Evidence, array<String>[]()[])

Executes the assembly given its display name, using the specified evidence and arguments.

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

Syntax

Visual Basic (Declaration)

Public Function ExecuteAssemblyByName ( _
    assemblyName As String, _
    assemblySecurity As Evidence, _
    ParamArray args As String() _
) As Integer

Visual Basic (Usage)

Dim instance As AppDomain
Dim assemblyName As String
Dim assemblySecurity As Evidence
Dim args As String()
Dim returnValue As Integer

returnValue = instance.ExecuteAssemblyByName(assemblyName, _
    assemblySecurity, args)

public int ExecuteAssemblyByName(
    string assemblyName,
    Evidence assemblySecurity,
    params string[] args
)

Visual C++

public:
int ExecuteAssemblyByName(
    String^ assemblyName, 
    Evidence^ assemblySecurity, 
    ... array<String^>^ args
)

JScript

public function ExecuteAssemblyByName(
    assemblyName : String, 
    assemblySecurity : Evidence, 
    ... args : String[]
) : int

Parameters

assemblyName: Type: System..::.String
The display name of the assembly. See Assembly..::.FullName.

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

args: Type: array<System..::.String>[]()[]
Command-line arguments to pass when starting the process.

Return Value

Type: System..::.Int32
The value returned by the entry point of the assembly.

Exceptions

Exception	Condition
ArgumentNullException	assemblyName is nullNothingnullptra null reference (Nothing in Visual Basic).
FileNotFoundException	The assembly specified by assemblyName is not found.
FileLoadException	The assembly specified by assemblyName was found, but could not be loaded.
BadImageFormatException	The assembly specified by assemblyName is not a valid assembly. -or- Version 2.0 or later of the common language runtime is currently loaded and assemblyName was compiled with a later version.
AppDomainUnloadedException	The operation is attempted on an unloaded application domain.

Remarks

The ExecuteAssemblyByName method provides similar functionality to the ExecuteAssembly method, but specifies the assembly by display name or AssemblyName rather than by file location. Therefore, ExecuteAssemblyByName loads assemblies with the Load method rather than with the LoadFile method.

The assembly begins executing at the entry point specified in the .NET Framework header.

This method does not create a new process or application domain, and it does not execute the entry point method on a new thread.

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

.NET Framework Security

FileIOPermission
for access to read from a file or directory, for access to the information in the path itself, and for redirecting a display name to a path. Associated enumerations: FileIOPermissionAccess..::.Read, FileIOPermissionAccess..::.PathDiscovery.
SecurityPermission
to load an assembly with evidence. Associated enumeration: SecurityPermissionFlag..::.ControlEvidence.
WebPermission
for access to a Web site, when a display name is redirected to a URL.

Platforms

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

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

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

AppDomain Class

AppDomain Members

ExecuteAssemblyByName Overload

System Namespace

Evidence