AppDomain.ExecuteAssembly Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Executa o assembly contido no arquivo especificado.

Sobrecargas

ExecuteAssembly(String, String[], Byte[], AssemblyHashAlgorithm)	Obsoleto. Executa o assembly contido no arquivo especificado usando os argumentos, o valor de hash e o algoritmo de hash especificados.
ExecuteAssembly(String, String[])	Executa o assembly contido no arquivo especificado usando argumentos especificados.
ExecuteAssembly(String)	Executa o assembly contido no arquivo especificado.

ExecuteAssembly(String, String[], Byte[], AssemblyHashAlgorithm)

Origem:

AppDomain.cs

Cuidado

Code Access Security is not supported or honored by the runtime.

Executa o assembly contido no arquivo especificado usando os argumentos, o valor de hash e o algoritmo de hash especificados.

C#

[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public int ExecuteAssembly (string assemblyFile, string?[]? args, byte[]? hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

Parâmetros

assemblyFile

String

O nome do arquivo que contém o assembly a ser executado.

args

String[]

Os argumentos para o ponto de entrada do assembly.

hashValue

Byte[]

Representa o valor do código hash computado.

hashAlgorithm

AssemblyHashAlgorithm

Representa o algoritmo de hash usado pelo manifesto do assembly.

Retornos

Int32

O valor retornado pelo ponto de entrada do assembly.

Atributos

ObsoleteAttribute

Exceções

ArgumentNullException

assemblyFile é null.

FileNotFoundException

assemblyFile não foi encontrado.

BadImageFormatException

assemblyFile não é um assembly válido para o runtime carregado no momento.

AppDomainUnloadedException

A operação é tentada em um domínio de aplicativo descarregado.

FileLoadException

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.

MissingMethodException

O assembly especificado não tem ponto de entrada.

Exemplos

O exemplo a seguir demonstra como usar uma das sobrecargas de ExecuteAssembly em dois domínios diferentes.

C#

class ExecuteAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;
      AppDomain otherDomain = AppDomain.CreateDomain("otherDomain");

      currentDomain.ExecuteAssembly("MyExecutable.exe");
      // Prints "MyExecutable running on [default]"

      otherDomain.ExecuteAssembly("MyExecutable.exe");
      // Prints "MyExecutable running on otherDomain"
   }
}

Comentários

Atenção

O CAS (Segurança de Acesso do Código) foi preterido em todas as versões do .NET Framework e do .NET. As versões recentes do .NET não aceitam anotações de CAS e produzem erros caso as APIs relacionadas ao CAS sejam usadas. Os desenvolvedores devem buscar meios alternativos de realizar tarefas de segurança.

O assembly começa a ser executado no ponto de entrada especificado no cabeçalho do .NET Framework.

Este método não cria um novo processo ou um domínio de aplicativo e não executa o método de ponto de entrada em um novo thread.

Este método carrega assemblies usando o método LoadFile. Também é possível executar assemblies usando o método ExecuteAssemblyByName, que carrega assemblies usando o método Load.

ExecuteAssembly(String, String[])

Origem:

AppDomain.cs

Executa o assembly contido no arquivo especificado usando argumentos especificados.

C#

public int ExecuteAssembly (string assemblyFile, string?[]? args);

Parâmetros

assemblyFile

String

O nome do arquivo que contém o assembly a ser executado.

args

String[]

Os argumentos para o ponto de entrada do assembly.

Retornos

Int32

O valor retornado pelo ponto de entrada do assembly.

Exceções

ArgumentNullException

assemblyFile é null.

FileNotFoundException

assemblyFile não foi encontrado.

BadImageFormatException

assemblyFile não é um assembly válido para o runtime carregado no momento.

AppDomainUnloadedException

A operação é tentada em um domínio de aplicativo descarregado.

FileLoadException

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.

MissingMethodException

O assembly especificado não tem ponto de entrada.

Exemplos

O exemplo a seguir demonstra como usar uma das sobrecargas de ExecuteAssembly em dois domínios diferentes.

C#

class ExecuteAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;
      AppDomain otherDomain = AppDomain.CreateDomain("otherDomain");

      currentDomain.ExecuteAssembly("MyExecutable.exe");
      // Prints "MyExecutable running on [default]"

      otherDomain.ExecuteAssembly("MyExecutable.exe");
      // Prints "MyExecutable running on otherDomain"
   }
}

Comentários

O assembly começa a ser executado no ponto de entrada especificado no cabeçalho do .NET Framework.

Este método não cria um novo processo ou um domínio de aplicativo e não executa o método de ponto de entrada em um novo thread.

Este método carrega assemblies usando o método LoadFile. Também é possível executar assemblies usando o método ExecuteAssemblyByName, que carrega assemblies usando o método Load.

ExecuteAssembly(String)

Origem:

AppDomain.cs

Executa o assembly contido no arquivo especificado.

C#

public int ExecuteAssembly (string assemblyFile);

Parâmetros

assemblyFile

String

O nome do arquivo que contém o assembly a ser executado.

Retornos

Int32

O valor retornado pelo ponto de entrada do assembly.

Exceções

ArgumentNullException

assemblyFile é null.

FileNotFoundException

assemblyFile não foi encontrado.

BadImageFormatException

assemblyFile não é um assembly válido para o runtime carregado no momento.

AppDomainUnloadedException

A operação é tentada em um domínio de aplicativo descarregado.

FileLoadException

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.

MissingMethodException

O assembly especificado não tem ponto de entrada.

Exemplos

O exemplo a seguir demonstra como usar uma das sobrecargas de ExecuteAssembly em dois domínios diferentes.

C#

class ExecuteAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;
      AppDomain otherDomain = AppDomain.CreateDomain("otherDomain");

      currentDomain.ExecuteAssembly("MyExecutable.exe");
      // Prints "MyExecutable running on [default]"

      otherDomain.ExecuteAssembly("MyExecutable.exe");
      // Prints "MyExecutable running on otherDomain"
   }
}

Comentários

O assembly começa a ser executado no ponto de entrada especificado no cabeçalho do .NET Framework.

Este método não cria um novo processo ou um domínio de aplicativo e não executa o método de ponto de entrada em um novo thread.

Este método carrega assemblies usando o método LoadFile. Também é possível executar assemblies usando o método ExecuteAssemblyByName, que carrega assemblies usando o método Load.

Para criar o AppDomain para carregar e executar, use o CreateDomain método .