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.

Комментарии

Нельзя выполнять код из сборки, загруженной в контекст только для отражения.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 является пустой строкой ("").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.

Комментарии

Зависимости не загружаются автоматически в контекст только для отражения.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.

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