Assembly.ReflectionOnlyLoad Метод

Определение

Пространство имен:

System.Reflection

Сборки:

netstandard.dll, System.Runtime.dll

Загружает сборку в контекст только для отражения, где его можно проверить, но не выполнять.

Перегрузки

Имя	Описание
ReflectionOnlyLoad(Byte[])	Устаревшие.. Загружает сборку из общего формата файлов объектов (COFF), содержащего созданную сборку. Сборка загружается в контекст приложения вызывающего объекта только отражение.
ReflectionOnlyLoad(String)	Устаревшие.. Загружает сборку в контекст только для отражения, учитывая отображаемое имя.

ReflectionOnlyLoad(Byte[])

Исходный код:

Assembly.cs

Внимание

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Загружает сборку из общего формата файлов объектов (COFF), содержащего созданную сборку. Сборка загружается в контекст приложения вызывающего объекта только отражение.

public:
 static System::Reflection::Assembly ^ ReflectionOnlyLoad(cli::array <System::Byte> ^ rawAssembly);

[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 ReflectionOnlyLoad(byte[] rawAssembly);

[<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 ReflectionOnlyLoad : byte[] -> System.Reflection.Assembly

Public Shared Function ReflectionOnlyLoad (rawAssembly As Byte()) As Assembly

Параметры

rawAssembly

Byte[]

Массив байтов, представляющий собой образ на основе COFF, содержащий созданную сборку.

Возвращаемое значение

Assembly

Загруженная сборка.

Атрибуты

RequiresUnreferencedCodeAttribute ObsoleteAttribute

Исключения

ArgumentNullException

rawAssembly равно null.

BadImageFormatException

rawAssembly не является допустимой сборкой для текущей загруженной среды выполнения.

FileLoadException

rawAssembly невозможно загрузить.

PlatformNotSupportedException

Только .NET Core и .NET 5+ : во всех случаях.

Комментарии

Невозможно выполнить код из сборки, загруженной в контекст только отражения. Чтобы выполнить код, сборка должна быть загружена в контекст выполнения, а также с помощью Load метода.

Контекст только отражения отличается от других контекстов. Сборки, загруженные в контекст, можно выгрузить только путем выгрузки домена приложения.

ReflectionOnlyLoad(String)

Исходный код:

Assembly.cs

Внимание

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Загружает сборку в контекст только для отражения, учитывая отображаемое имя.

public:
 static System::Reflection::Assembly ^ ReflectionOnlyLoad(System::String ^ assemblyString);

[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 ReflectionOnlyLoad(string assemblyString);

[<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 ReflectionOnlyLoad : string -> System.Reflection.Assembly

Public Shared Function ReflectionOnlyLoad (assemblyString As String) As Assembly

Параметры

assemblyString

String

Отображаемое имя сборки, возвращаемое свойством FullName .

Возвращаемое значение

Assembly

Загруженная сборка.

Атрибуты

RequiresUnreferencedCodeAttribute ObsoleteAttribute

Исключения

ArgumentNullException

assemblyString равно null.

ArgumentException

assemblyString — пустая строка ("").

FileNotFoundException

assemblyString не найден.

FileLoadException

assemblyString найдено, но не может быть загружено.

BadImageFormatException

assemblyString не является допустимой сборкой для текущей загруженной среды выполнения.

PlatformNotSupportedException

Только .NET Core и .NET 5+ : во всех случаях.

Комментарии

Зависимости не загружаются автоматически в контекст только для отражения.

Невозможно выполнить код из сборки, загруженной в контекст только отражения. Чтобы выполнить код, сборка должна быть загружена в контекст выполнения, а также с помощью Load метода.

Контекст только отражения отличается от других контекстов. Сборки, загруженные в контекст, можно выгрузить только путем выгрузки домена приложения.