Assembly.ReflectionOnlyLoad Assembly.ReflectionOnlyLoad Assembly.ReflectionOnlyLoad Assembly.ReflectionOnlyLoad Method

Определение

Загружает сборку в контекст, предназначенный только для отражения, где она может быть проанализирована, но не может быть выполнена.Loads an assembly into the reflection-only context, where it can be examined but not executed.

Перегрузки

ReflectionOnlyLoad(Byte[]) ReflectionOnlyLoad(Byte[]) ReflectionOnlyLoad(Byte[]) ReflectionOnlyLoad(Byte[])

Загружает сборку из образа в формате COFF, содержащего порожденную сборку.Loads the assembly from a common object file format (COFF)-based image containing an emitted assembly. Сборка загружается в контекст, предназначенный только для отражения, который относится к домену приложения вызывающего объекта.The assembly is loaded into the reflection-only context of the caller's application domain.

ReflectionOnlyLoad(String) ReflectionOnlyLoad(String) ReflectionOnlyLoad(String) ReflectionOnlyLoad(String)

Загружает сборку с заданным отображаемым именем в контекст, предназначенный только для отражения.Loads an assembly into the reflection-only context, given its display name.

ReflectionOnlyLoad(Byte[]) ReflectionOnlyLoad(Byte[]) ReflectionOnlyLoad(Byte[]) ReflectionOnlyLoad(Byte[])

Загружает сборку из образа в формате COFF, содержащего порожденную сборку.Loads the assembly from a common object file format (COFF)-based image containing an emitted assembly. Сборка загружается в контекст, предназначенный только для отражения, который относится к домену приложения вызывающего объекта.The assembly is loaded into the reflection-only context of the caller's application domain.

public:
 static System::Reflection::Assembly ^ ReflectionOnlyLoad(cli::array <System::Byte> ^ rawAssembly);
public static System.Reflection.Assembly ReflectionOnlyLoad (byte[] rawAssembly);
static member ReflectionOnlyLoad : byte[] -> System.Reflection.Assembly
Public Shared Function ReflectionOnlyLoad (rawAssembly As Byte()) As Assembly

Параметры

rawAssembly
Byte[]

Массив байтов, который является образом в формате COFF, содержащим созданную сборку.A byte array that is a COFF-based image containing an emitted assembly.

Возвраты

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

Исключения

rawAssembly не является допустимой сборкой.rawAssembly is not a valid assembly.

- или --or- В настоящий момент загружена среда CLR версии 2.0 или более поздней версии. Сборка rawAssembly была скомпилирована в более поздней версии.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Не удается загрузить rawAssembly.rawAssembly cannot be loaded.

Только в .NET Core: этот элемент не поддерживается..NET Core only: This member is not supported.

Комментарии

Невозможно выполнить код из сборки, загруженной в контекст, предназначенный только для отражения.You cannot execute code from an assembly loaded into the reflection-only context. Для выполнения кода сборка должна быть также загружена в контекст выполнения с помощью Load метода.To execute code, the assembly must be loaded into the execution context as well, using the Load method.

Контекст, предназначенный только для отражения, отличается от контекста других контекстов.The reflection-only context is no different from other contexts. Сборки, загружаемые в контекст, можно выгружать только путем выгрузки домена приложения.Assemblies that are loaded into the context can be unloaded only by unloading the application domain.

ReflectionOnlyLoad(String) ReflectionOnlyLoad(String) ReflectionOnlyLoad(String) ReflectionOnlyLoad(String)

Загружает сборку с заданным отображаемым именем в контекст, предназначенный только для отражения.Loads an assembly into the reflection-only context, given its display name.

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

Параметры

assemblyString
String String String String

Отображаемое имя сборки, возвращаемое свойством FullName.The display name of the assembly, as returned by the FullName property.

Возвраты

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

Исключения

Свойство assemblyString имеет значение null.assemblyString is null.

Параметр assemblyString является пустой строкой ("").assemblyString is an empty string ("").

assemblyString не найден.assemblyString is not found.

assemblyString найден, но не может быть загружен.assemblyString is found, but cannot be loaded.

assemblyString не является допустимой сборкой.assemblyString is not a valid assembly.

-или--or- В настоящий момент загружена среда CLR версии 2.0 или более поздней версии. Сборка assemblyString была скомпилирована в более поздней версии.Version 2.0 or later of the common language runtime is currently loaded and assemblyString was compiled with a later version.

Только в .NET Core: этот элемент не поддерживается..NET Core only: This member is not supported.

Комментарии

Зависимости не загружаются автоматически в контекст, предназначенный только для отражения.Dependencies are not automatically loaded into the reflection-only context.

Невозможно выполнить код из сборки, загруженной в контекст, предназначенный только для отражения.You cannot execute code from an assembly loaded into the reflection-only context. Для выполнения кода сборка должна быть также загружена в контекст выполнения с помощью Load метода.To execute code, the assembly must be loaded into the execution context as well, using the Load method.

От свидетельства зависит, предоставляются ли сборке определенные разрешения.Whether certain permissions are granted or not granted to an assembly is based on evidence. Ниже приведены правила объединения свидетельств сборки и безопасности.The rules for assembly and security evidence merging are as follows:

Примечание

Отражение исполняемых файлов, скомпилированных C++ в, FileLoadExceptionможет вызвать исключение.Reflecting on executable files compiled in C++ might throw a FileLoadException. Скорее всего, это вызвано тем C++ , что компилятор вырезает адреса перемещения или раздел. reloc из исполняемого файла.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Чтобы сохранить адрес. reloc, укажите /fixed:no время связывания.To preserve the .reloc address, specify /fixed:no when you are linking.

Контекст, предназначенный только для отражения, отличается от контекста других контекстов.The reflection-only context is no different from other contexts. Сборки, загружаемые в контекст, можно выгружать только путем выгрузки домена приложения.Assemblies that are loaded into the context can be unloaded only by unloading the application domain.

Применяется к