Assembly.LoadFile Método

  • Referência

Definição

Namespace:
System.Reflection
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Carrega o conteúdo de um arquivo do assembly.

Sobrecargas

LoadFile(String)

Carrega o conteúdo de um arquivo do assembly no caminho especificado.
LoadFile(String, Evidence)
Obsoleto.

Carrega um assembly dado seu caminho, carregando o assembly usando a evidência fornecida.

LoadFile(String)

Origem:
Assembly.cs
Origem:
Assembly.cs
Origem:
Assembly.cs

Carrega o conteúdo de um arquivo do assembly no caminho especificado.

public:
 static System::Reflection::Assembly ^ LoadFile(System::String ^ path);
public static System.Reflection.Assembly LoadFile (string path);
static member LoadFile : string -> System.Reflection.Assembly
Public Shared Function LoadFile (path As String) As Assembly

Parâmetros

path
String

O caminho totalmente qualificado do arquivo a ser carregado.

Retornos

Assembly

O assembly carregado.

Exceções

ArgumentException

O argumento path não é um caminho absoluto.

ArgumentNullException

O parâmetro path é null.

FileLoadException

Não foi possível carregar um arquivo que foi encontrado.

- ou -

A capacidade de executar código em assemblies remotos está desabilitada. Veja <loadFromRemoteSources>.

FileNotFoundException

O parâmetro path é uma cadeia de caracteres vazia ("") ou não existe.

BadImageFormatException

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

Comentários

Use o LoadFile método para carregar e examinar assemblies que têm a mesma identidade, mas estão localizados em caminhos diferentes. LoadFilenão carrega arquivos no contexto de carregamento e não resolve dependências usando o caminho de carga, como o LoadFrom método faz. LoadFile é útil nesse cenário limitado porque LoadFrom não pode ser usado para carregar assemblies que têm as mesmas identidades, mas caminhos diferentes; ele carregará apenas o primeiro assembly desse tipo.

Começando com .NET Framework 4, se path especificar um assembly em um local remoto, o carregamento do assembly será desabilitado por padrão e o LoadFile método gerará um FileLoadException. Para habilitar a execução do código carregado de locais remotos, você pode usar o <loadFromRemoteSources> elemento de configuração .

Aplica-se a

LoadFile(String, Evidence)

Cuidado

This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of LoadFile which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Carrega um assembly dado seu caminho, carregando o assembly usando a evidência fornecida.

public:
 static System::Reflection::Assembly ^ LoadFile(System::String ^ path, System::Security::Policy::Evidence ^ securityEvidence);
public static System.Reflection.Assembly LoadFile (string path, System.Security.Policy.Evidence securityEvidence);
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of LoadFile which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly LoadFile (string path, System.Security.Policy.Evidence securityEvidence);
static member LoadFile : string * System.Security.Policy.Evidence -> System.Reflection.Assembly
[<System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of LoadFile which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member LoadFile : string * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function LoadFile (path As String, securityEvidence As Evidence) As Assembly

Parâmetros

path
String

O caminho totalmente qualificado do arquivo do assembly.

securityEvidence
Evidence

Evidência para carregar o assembly.

Retornos

Assembly

O assembly carregado.

Atributos
ObsoleteAttribute

Exceções

ArgumentException

O argumento path não é um caminho absoluto.

ArgumentNullException

O parâmetro path é null.

FileNotFoundException

O parâmetro path é uma cadeia de caracteres vazia ("") ou não existe.

FileLoadException

Não foi possível carregar um arquivo que foi encontrado.

- ou -

A capacidade de executar código em assemblies remotos está desabilitada. Veja <loadFromRemoteSources>.

BadImageFormatException

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

NotSupportedException

securityEvidence não é null. Por padrão, a política CAS herdada não está habilitada no .NET Framework 4; quando não está habilitada, securityEvidence deve ser null.

Comentários

Use o LoadFile método para carregar e examinar assemblies que têm a mesma identidade, mas estão localizados em caminhos diferentes. LoadFilenão carrega arquivos no LoadFrom contexto e não resolve dependências usando o caminho de carga, como o LoadFrom método faz. LoadFile é útil nesse cenário limitado porque LoadFrom não pode ser usado para carregar assemblies que têm as mesmas identidades, mas caminhos diferentes; ele carregará apenas o primeiro assembly desse tipo.

Começando com .NET Framework 4, se path especificar um assembly em um local remoto, o carregamento do assembly será desabilitado por padrão e o LoadFile método gerará um FileLoadException. Para habilitar a execução do código carregado de locais remotos, você pode usar o <loadFromRemoteSources> elemento de configuração .

Aplica-se a