Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

AppDomain::ExecuteAssembly Method (String^)

.NET Framework (current version)
 

Executes the assembly contained in the specified file.

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

C#
C++
F#
VB
Copy 
public:
virtual int ExecuteAssembly(
	String^ assemblyFile
) sealed

Parameters

assemblyFile
Type: System::String^

The name of the file that contains the assembly to execute.

Return Value

Type: System::Int32

The value returned by the entry point of the assembly.

Implements

_AppDomain::ExecuteAssembly(String^)

Exception Condition
ArgumentNullException

assemblyFile is null.

FileNotFoundException

assemblyFile is not found.

BadImageFormatException

assemblyFile is not a valid assembly.

-or-

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

AppDomainUnloadedException

The operation is attempted on an unloaded application domain.

FileLoadException

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

MissingMethodException

The specified assembly has no entry point.

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.

This method loads assemblies using the LoadFile method. You can also execute assemblies using the ExecuteAssemblyByName method, which loads assemblies using the Load method.

To create the AppDomain to load and execute, use the CreateDomain method.

The following sample demonstrates using one of the overloads of ExecuteAssembly on two different domains.

C#
C++
VB
Copy 
int main()
{
   AppDomain^ currentDomain = AppDomain::CurrentDomain;
   AppDomain^ otherDomain = AppDomain::CreateDomain( "otherDomain" );
   currentDomain->ExecuteAssembly( "MyExecutable.exe" );

   // Prints S"MyExecutable running on [default]"
   otherDomain->ExecuteAssembly( "MyExecutable.exe" );

   // Prints S"MyExecutable running on otherDomain"
}

FileIOPermission

for access to read from a file or directory, and for access to the information in the path itself. Associated enumerations: FileIOPermissionAccess::Read, FileIOPermissionAccess::PathDiscovery.

WebPermission

for reading a URI that does not begin with "file://".

UIPermission

to execute a console application. Associated enumeration: PermissionState::Unrestricted.

.NET Framework
Available since 1.1
Return to top
Show: