AppDomain::ExecuteAssembly Method (String^)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Executes the assembly contained in the specified file.

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

virtual int ExecuteAssembly(
	String^ assemblyFile
) sealed


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.

Exception Condition

assemblyFile is null.


assemblyFile is not found.


assemblyFile is not a valid assembly.


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


The operation is attempted on an unloaded application domain.


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


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.

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"


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.


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


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

.NET Framework
Available since 1.1
Return to top