Assembly.ReflectionOnlyLoadFrom(String) Método

Definição

Namespace:
System.Reflection
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
Assembly.cs
Origem:
Assembly.cs
Origem:
Assembly.cs
Origem:
Assembly.cs
Origem:
Assembly.cs

Cuidado

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Carrega um assembly no contexto somente reflexão, considerando seu caminho.

public:
 static System::Reflection::Assembly ^ ReflectionOnlyLoadFrom(System::String ^ assemblyFile);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")]
[System.Obsolete("ReflectionOnly loading is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0018", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Reflection.Assembly ReflectionOnlyLoadFrom(string assemblyFile);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")]
public static System.Reflection.Assembly ReflectionOnlyLoadFrom(string assemblyFile);
public static System.Reflection.Assembly ReflectionOnlyLoadFrom(string assemblyFile);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")>]
[<System.Obsolete("ReflectionOnly loading is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0018", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member ReflectionOnlyLoadFrom : string -> System.Reflection.Assembly
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")>]
static member ReflectionOnlyLoadFrom : string -> System.Reflection.Assembly
static member ReflectionOnlyLoadFrom : string -> System.Reflection.Assembly
Public Shared Function ReflectionOnlyLoadFrom (assemblyFile As String) As Assembly

Parâmetros

assemblyFile
String

O caminho do arquivo que contém o manifesto do assembly.

Retornos

Assembly

O assembly carregado.

Atributos
RequiresUnreferencedCodeAttribute ObsoleteAttribute

Exceções

ArgumentNullException

assemblyFile é null.

FileNotFoundException

assemblyFile não foi encontrado ou o módulo que você está tentando carregar não especifica uma extensão de nome de arquivo.

FileLoadException

assemblyFile é encontrado, mas não foi possível carregar.

BadImageFormatException

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

SecurityException

Uma base de código que não começa com "file://" foi especificada sem o necessário WebPermission.

PathTooLongException

O nome do assembly excede o comprimento máximo definido pelo sistema.

ArgumentException

assemblyFile é uma cadeia de caracteres vazia ("").

PlatformNotSupportedException

Somente .NET Core e .NET 5+: em todos os casos.

Comentários

As dependências não são carregadas automaticamente no contexto somente reflexão. Para carregar dependências automaticamente, manipule o ReflectionOnlyAssemblyResolve evento e carregue a dependência no manipulador de eventos.

Você não pode executar o código de um assembly que foi carregado no contexto somente reflexão. Para executar o código, carregue o assembly com o LoadFile método.

O assemblyFile parâmetro deve se referir a um URI sem caracteres de escape. Esse método fornece caracteres de escape para todos os caracteres inválidos no URI.

O caminho especificado é assemblyFile relativo ao diretório atual.

O contexto somente reflexão não é diferente de outros contextos. Assemblies carregados no contexto só podem ser descarregados descarregando o domínio do aplicativo.

Aplica-se a