Assembly.LoadFile Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Carrega o conteúdo de um ficheiro assembly.
Sobrecargas
| Name | Description |
|---|---|
| LoadFile(String) |
Carrega o conteúdo de um ficheiro assembly no caminho especificado. |
| LoadFile(String, Evidence) |
Obsoleto.
Carrega um conjunto dado o seu caminho, carregando o conjunto usando a evidência fornecida. |
LoadFile(String)
Carrega o conteúdo de um ficheiro 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 ficheiro para carregar.
Devoluções
O conjunto carregado.
Exceções
O path argumento não é um caminho absoluto.
O path parâmetro é null.
Um ficheiro encontrado não pôde ser carregado.
-ou-
.NET Framework apenas: path especifica uma localização desativada com base em <loadFromRemoteSources>.
O path parâmetro é uma cadeia vazia ("") ou não existe.
path não é uma assembly válida para o runtime atualmente carregado.
Observações
Esta API está presente no .NET Core para compatibilidade, mas recomenda-se usar sobrecargas AssemblyLoadContext em vez disso.
O assembly é carregado num novo AssemblyLoadContext criado para este propósito. Para mais informações sobre carregamento de montagem, consulte Algoritmo de carregamento de montagem gerido.
Use o LoadFile método para carregar e examinar assemblies que tenham a mesma identidade, mas estejam localizados em caminhos diferentes. LoadFile não carrega ficheiros no contexto load-from e não resolve dependências usando o load path, como o LoadFrom método faz. LoadFile é útil neste cenário limitado porque LoadFrom não pode ser usado para carregar assemblies que tenham as mesmas identidades mas caminhos diferentes; carregará apenas o primeiro assembly desse tipo.
.NET Framework apenas: Veja <loadFromRemoteSources> para carregar assemblies a partir de locais remotos.
Aplica-se a
LoadFile(String, Evidence)
Atenção
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 conjunto dado o seu caminho, carregando o conjunto 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 ficheiro assembly.
- securityEvidence
- Evidence
Provas para carregar a assembleia.
Devoluções
O conjunto carregado.
- Atributos
Exceções
O path argumento não é um caminho absoluto.
O path parâmetro é null.
O path parâmetro é uma cadeia vazia ("") ou não existe.
Um ficheiro encontrado não pôde ser carregado.
-ou-
path especifica um local que está desativado com base no <loadFromRemoteSources>.
path não é uma assembly válida para o runtime atualmente carregado.
securityEvidence não nullé . Por defeito, a política CAS legada não está ativada no .NET Framework 4; quando não está ativada, securityEvidence deve ser null.
Observações
Use o LoadFile método para carregar e examinar assemblies que tenham a mesma identidade, mas estejam localizados em caminhos diferentes. LoadFile não carrega ficheiros no LoadFrom contexto e não resolve dependências usando o caminho de carga, como o LoadFrom método faz. LoadFile é útil neste cenário limitado porque LoadFrom não pode ser usado para carregar assemblies que tenham as mesmas identidades mas caminhos diferentes; carregará apenas o primeiro assembly desse tipo.
Veja <loadFromRemoteSources> para carregar conjuntos a partir de locais remotos.