Assembly.Load Метод

Определение

Загружает сборку.Loads an assembly.

Перегрузки

Load(Byte[], Byte[], SecurityContextSource)

Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и необязательно содержащим символы и задающим источник для контекста безопасности.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and specifying the source for the security context. Сборка загружается в домен приложения вызывающего объекта.The assembly is loaded into the application domain of the caller.

Load(Byte[], Byte[], Evidence)

Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и (необязательно) символы и свидетельство для сборки.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and evidence for the assembly. Сборка загружается в домен приложения вызывающего объекта.The assembly is loaded into the application domain of the caller.

Load(String, Evidence)

Загружает сборку с заданным отображаемым именем. Сборка загружается в домен вызывающего объекта с использованием переданного основания.Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.

Load(AssemblyName, Evidence)

Загружает сборку с заданным именем AssemblyName.Loads an assembly given its AssemblyName. Сборка загружена в домен вызывающего объекта с использованием переданного свидетельства.The assembly is loaded into the domain of the caller using the supplied evidence.

Load(Byte[])

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

Load(String)

Загружает сборку с указанным именем.Loads an assembly with the specified name.

Load(AssemblyName)

Загружает сборку с заданным именем AssemblyName.Loads an assembly given its AssemblyName.

Load(Byte[], Byte[])

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

Load(Byte[], Byte[], SecurityContextSource)

Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и необязательно содержащим символы и задающим источник для контекста безопасности.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and specifying the source for the security context. Сборка загружается в домен приложения вызывающего объекта.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore, System::Security::SecurityContextSource securityContextSource);
public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore, System.Security.SecurityContextSource securityContextSource);
static member Load : byte[] * byte[] * System.Security.SecurityContextSource -> System.Reflection.Assembly

Параметры

rawAssembly
Byte[]

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

rawSymbolStore
Byte[]

Массив байтов, содержащий необработанные байты, которые представляют символы для сборки.A byte array that contains the raw bytes representing the symbols for the assembly.

securityContextSource
SecurityContextSource

Источник контекста безопасности.The source of the security context.

Возвраты

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

Исключения

rawAssemblynull.rawAssembly is null.

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

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

Значение securityContextSource не является одним из значений перечисления.The value of securityContextSource is not one of the enumeration values.

Комментарии

Сборка загружается в домен приложения вызывающего объекта, используя указанный источник для контекста безопасности.The assembly is loaded into the application domain of the caller using the specified source for the security context. Если указан rawSymbolStore, также загружаются необработанные байты, представляющие символы для сборки.If rawSymbolStore was specified, the raw bytes that represent the symbols for the assembly are also loaded.

Load(Byte[], Byte[], Evidence)

Предупреждение

Этот API устарел.

Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и (необязательно) символы и свидетельство для сборки.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and evidence for the assembly. Сборка загружается в домен приложения вызывающего объекта.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore, System::Security::Policy::Evidence ^ securityEvidence);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore, System.Security.Policy.Evidence securityEvidence);
static member Load : byte[] * byte[] * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (rawAssembly As Byte(), rawSymbolStore As Byte(), securityEvidence As Evidence) As Assembly

Параметры

rawAssembly
Byte[]

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

rawSymbolStore
Byte[]

Массив байтов, содержащий необработанные байты, которые представляют символы для сборки.A byte array that contains the raw bytes representing the symbols for the assembly.

securityEvidence
Evidence

Свидетельство для загрузки сборки.Evidence for loading the assembly.

Возвраты

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

Атрибуты

Исключения

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

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

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

Сборка или модуль был загружен дважды с двумя разными свидетельствами.An assembly or module was loaded twice with two different evidences.

securityEvidence не является null.securityEvidence is not null. По умолчанию устаревшая политика CAS не включена в .NET Framework 4.NET Framework 4; если она не включена, параметр securityEvidence должен иметь значение null.By default, legacy CAS policy is not enabled in the .NET Framework 4.NET Framework 4; when it is not enabled, securityEvidence must be null.

Комментарии

Сборка загружена в домен вызывающего объекта с использованием переданного свидетельства.The assembly is loaded into the domain of the caller using the supplied evidence. Также загружаются необработанные байты, представляющие символы для сборки.The raw bytes representing the symbols for the assembly are also loaded.

От свидетельства зависит, предоставляются ли сборке определенные разрешения.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:

  • При использовании метода Load без параметра Evidence сборка загружается с свидетельством, которое предоставляет загрузчик.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • При использовании метода Load с параметром Evidence объединяются части свидетельств.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Части свидетельства, предоставленные в качестве аргумента методу Load, заменяют части свидетельств, предоставляемые загрузчиком.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • При использовании перегрузки метода Load с параметром Byte[] для загрузки образа COFF свидетельство наследуется от вызывающей сборки.When you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is inherited from the calling assembly. Это относится к .NET Framework версии 1,1 с пакетом обновления 1 (SP1) и последующим выпускам.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Примечание

    В .NET Framework версии 1,0 и в версии 1,1 без SP1 при использовании перегрузки метода Load с параметром Byte[] для загрузки образа COFF свидетельство сочетается.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url и Site наследуются от вызывающей сборки, а Hash и StrongName берутся из сборки COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • При использовании метода Load с параметром Byte[] и Evidence для загрузки образа COFF используется только предоставляемое свидетельство.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Свидетельство вызывающей сборки и свидетельство образа COFF игнорируются.Evidence of the calling assembly and evidence of the COFF image are ignored.

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

При вызове метода [], Byte<XREF: System. Reflection. Assembly. Load% 2A > более одного раза в одной сборке, но с другим заданным свидетельством среда CLR не вызывает FileLoadException, так как равенство и целостность из разных спецификаций свидетельства определить нельзя.If you call the [], Byte<xref:System.Reflection.Assembly.Load%2A> method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. Свидетельством, которое сначала прошло, является используемое свидетельство.The evidence that first succeeds is the evidence that is used.

Обратите внимание, что эта перегрузка метода всегда создает новый объект Assembly с собственным сопоставлением.Note that this method overload always creates a new Assembly object with its own mapping.

Безопасность

SecurityPermission
для возможности предоставления свидетельства.for the ability to supply evidence. Связанное перечисление: ControlEvidence.Associated enumeration: ControlEvidence. Действие безопасности: Demand.Security action: Demand.

Load(String, Evidence)

Предупреждение

Этот API устарел.

Загружает сборку с заданным отображаемым именем. Сборка загружается в домен вызывающего объекта с использованием переданного основания.Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString, System::Security::Policy::Evidence ^ assemblySecurity);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (string assemblyString, System.Security.Policy.Evidence assemblySecurity);
static member Load : string * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (assemblyString As String, assemblySecurity As Evidence) As Assembly

Параметры

assemblyString
String

Отображаемое имя сборки.The display name of the assembly.

assemblySecurity
Evidence

Свидетельство для загрузки сборки.Evidence for loading the assembly.

Возвраты

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

Атрибуты

Исключения

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

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

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.

Не удалось загрузить файл, который был найден.A file that was found could not be loaded.

- или --or-

Сборка или модуль был загружен дважды с двумя разными свидетельствами.An assembly or module was loaded twice with two different evidences.

Комментарии

FileLoadException возникает, если assemblyString задает полное имя сборки, а первая сборка, которая соответствует простому имени, имеет другую версию, язык и региональные параметры или маркер открытого ключа.FileLoadException is thrown if assemblyString specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. Загрузчик не продолжает поиск других сборок, соответствующих простому имени.The loader does not continue probing for other assemblies that match the simple name.

От свидетельства зависит, предоставляются ли сборке определенные разрешения.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:

  • При использовании метода Load без параметра Evidence сборка загружается с свидетельством, которое предоставляет загрузчик.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • При использовании метода Load с параметром Evidence объединяются части свидетельств.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Части свидетельства, предоставленные в качестве аргумента методу Load, заменяют части свидетельств, предоставляемые загрузчиком.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • При использовании перегрузки метода Load с параметром Byte[] для загрузки образа в формате COFF, свидетельство наследуется от вызывающей сборки.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Это относится к .NET Framework версии 1,1 с пакетом обновления 1 (SP1) и последующим выпускам.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Примечание

    В .NET Framework версии 1,0 и в версии 1,1 без SP1 при использовании перегрузки метода Load с параметром Byte[] для загрузки образа COFF свидетельство сочетается.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url и Site наследуются от вызывающей сборки, а Hash и StrongName берутся из сборки COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • При использовании метода Load с параметром Byte[] и Evidence для загрузки образа COFF используется только предоставляемое свидетельство.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Свидетельство вызывающей сборки и свидетельство образа COFF игнорируются.Evidence of the calling assembly and evidence of the COFF image is ignored.

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

Если этот метод вызывается более одного раза в одной сборке, но с другим заданным свидетельством, среда CLR не создает FileLoadException, так как не удается определить равенство и целостность разных спецификаций доказательств.If you call this method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. Свидетельством, которое сначала прошло, является используемое свидетельство.The evidence that first succeeds is the evidence that is used.

В .NET Framework версии 2,0 архитектура процессора добавляется в удостоверение сборки и может быть указана в качестве части строк имен сборок.In the .NET Framework version 2.0, processor architecture is added to assembly identity, and can be specified as part of assembly name strings. Например, "ProcessorArchitecture = MSIL".For example, "ProcessorArchitecture=msil". Однако рекомендуемый способ указания имени сборки — создать объект AssemblyName и передать его в соответствующую перегрузку метода Load.However, the recommended way to specify an assembly name is to create an AssemblyName object and pass it to an appropriate overload of the Load method. См. раздел AssemblyName.ProcessorArchitecture.See AssemblyName.ProcessorArchitecture.

Безопасность

SecurityPermission
для загрузки сборки с свидетельством.to load an assembly with evidence. Связанное перечисление: ControlEvidenceAssociated enumeration: ControlEvidence

Дополнительно

Load(AssemblyName, Evidence)

Предупреждение

Этот API устарел.

Загружает сборку с заданным именем AssemblyName.Loads an assembly given its AssemblyName. Сборка загружена в домен вызывающего объекта с использованием переданного свидетельства.The assembly is loaded into the domain of the caller using the supplied evidence.

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef, System::Security::Policy::Evidence ^ assemblySecurity);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef, System.Security.Policy.Evidence assemblySecurity);
static member Load : System.Reflection.AssemblyName * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (assemblyRef As AssemblyName, assemblySecurity As Evidence) As Assembly

Параметры

assemblyRef
AssemblyName

Объект, описывающий загружаемую сборку.The object that describes the assembly to be loaded.

assemblySecurity
Evidence

Свидетельство для загрузки сборки.Evidence for loading the assembly.

Возвраты

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

Атрибуты

Исключения

assemblyRefnull.assemblyRef is null.

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

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

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

Сборка или модуль был загружен дважды с двумя разными свидетельствами.An assembly or module was loaded twice with two different evidences.

- или --or-

assemblyRef указывает на удаленную сборку, но возможность выполнения кода в удаленных сборках отключена.assemblyRef specifies a remote assembly, but the ability to execute code in remote assemblies is disabled. См. элемент <loadFromRemoteSources>.See <loadFromRemoteSources>.

Комментарии

FileLoadException возникает, если assemblyRef задает полное имя сборки, а первая сборка, которая соответствует простому имени, имеет другую версию, язык и региональные параметры или маркер открытого ключа.FileLoadException is thrown if assemblyRef specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. Загрузчик не продолжает поиск других сборок, соответствующих простому имени.The loader does not continue probing for other assemblies that match the simple name. Начиная с .NET Framework 4, поскольку выполнение кода в удаленных сборках по умолчанию отключено, FileLoadException также создается, если assemblyRef указывает удаленную сборку.Starting with .NET Framework 4, because execution of code in remote assemblies is disabled by default, a FileLoadException is also thrown if assemblyRef specifies a remote assembly. Чтобы разрешить выполнение кода, загруженного из удаленных расположений, можно использовать элемент конфигурации <loadFromRemoteSources> .To enable execution of code loaded from remote locations, you can use the <loadFromRemoteSources> configuration element.

Примечание

Не используйте AssemblyName только с установленным свойством CodeBase.Do not use an AssemblyName with only the CodeBase property set. Свойство CodeBase не предоставляет никаких элементов удостоверения сборки (например, имени или версии), поэтому загрузка не происходит в соответствии с правилами загрузки по идентификатору, как и при ожидании от метода Load.The CodeBase property does not supply any elements of the assembly identity (such as name or version), so loading does not occur according to load-by-identity rules, as you would expect from the Load method. Вместо этого сборка загружается с помощью правил загрузки.Instead, the assembly is loaded using load-from rules. Сведения о недостатках использования контекста загрузки см. в разделе перегрузка метода Assembly.LoadFrom или рекомендации по загрузке сборки.For information about the disadvantages of using the load-from context, see the Assembly.LoadFrom method overload or Best Practices for Assembly Loading.

От свидетельства зависит, предоставляются ли сборке определенные разрешения.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:

  • При использовании метода Load без параметра Evidence сборка загружается с свидетельством, которое предоставляет загрузчик.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • При использовании метода Load с параметром Evidence объединяются части свидетельств.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Части свидетельства, предоставленные в качестве аргумента методу Load, заменяют части свидетельств, предоставляемые загрузчиком.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • При использовании перегрузки метода Load с параметром Byte[] для загрузки образа в формате COFF, свидетельство наследуется от вызывающей сборки.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Это относится к .NET Framework версии 1,1 с пакетом обновления 1 (SP1) и последующим выпускам.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Примечание

    В .NET Framework версии 1,0 и в версии 1,1 без SP1 при использовании перегрузки метода Load с параметром Byte[] для загрузки образа COFF свидетельство сочетается.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url и Site наследуются от вызывающей сборки, а Hash и StrongName берутся из сборки COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • При использовании метода Load с параметром Byte[] и Evidence для загрузки образа COFF используется только предоставляемое свидетельство.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Свидетельство вызывающей сборки и свидетельство образа COFF игнорируются.Evidence of the calling assembly and evidence of the COFF image is ignored.

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

Примечание

Если заданы и свойство AssemblyName.Name, и свойство AssemblyName.CodeBase, первая попытка загрузки сборки использует отображаемое имя (включая версию, культуру и т. д.), возвращенное свойством Assembly.FullName).If both the AssemblyName.Name property and the AssemblyName.CodeBase property are set, the first attempt to load the assembly uses the display name (including version, culture, and so on, as returned by the Assembly.FullName property). Если файл не найден, CodeBase используется для поиска сборки.If the file is not found, CodeBase is used to search for the assembly. Если сборка найдена с помощью CodeBase, отображаемое имя сопоставляется со сборкой.If the assembly is found using CodeBase, the display name is matched against the assembly. Если сопоставление завершается неудачей, выдается FileLoadException.If the match fails, a FileLoadException is thrown.

Если вы вызываете метод Load несколько раз в одной сборке, но с другим заданным свидетельством, среда CLR не создает FileLoadException, так как не удается определить равенство и целостность разных спецификаций доказательств.If you call the Load method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. Свидетельством, которое сначала прошло, является используемое свидетельство.The evidence that first succeeds is the evidence that is used.

Безопасность

FileIOPermission
для доступа к чтению из файла или каталога, а также для доступа к данным в самом пути.for access to read from a file or directory, and for access to the information in the path itself. Связанные перечисления: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

WebPermission
для чтения URI, который не начинается с "file://".for reading a URI that does not begin with "file://".

SecurityPermission
для загрузки сборки с свидетельством.to load an assembly with evidence. Связанное перечисление: ControlEvidenceAssociated enumeration: ControlEvidence

Дополнительно

Load(Byte[])

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

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly);
public static System.Reflection.Assembly Load (byte[] rawAssembly);
static member Load : byte[] -> System.Reflection.Assembly
Public Shared Function Load (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 имеет значение null.rawAssembly is null.

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.

Комментарии

Уровень доверия сборки, загружаемой с помощью этого метода, совпадает с уровнем доверия вызывающей сборки.The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. Чтобы загрузить сборку из массива байтов с уровнем доверия домена приложения, используйте перегрузку метода Load(Byte[], Byte[], SecurityContextSource).To load an assembly from a byte array with the trust level of the application domain, use the Load(Byte[], Byte[], SecurityContextSource) method overload. Дополнительные сведения об использовании свидетельств с перегрузками метода Load, принимающего байтовые массивы, см. в описании перегрузки метода Load(Byte[], Byte[], Evidence).For more information about the use of evidence with overloads of the Load method that take byte arrays, see the Load(Byte[], Byte[], Evidence) method overload.

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

Обратите внимание, что эта перегрузка метода всегда создает новый объект Assembly с собственным сопоставлением.Note that this method overload always creates a new Assembly object with its own mapping.

Load(String)

Загружает сборку с указанным именем.Loads an assembly with the specified name.

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

Параметры

assemblyString
String

Длинная или короткая форма имени сборки.The long or short form of the assembly name.

Возвраты

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

Исключения

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

assemblyString представляет собой строку нулевой длины.assemblyString is a zero-length string.

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

Не удалось загрузить файл, который был найден.A file that was found could not 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.

Примеры

В следующем примере загружается сборка с заданным ее полным именем и перечисляются все типы, содержащиеся в указанной сборке.The following example loads an assembly given its fully qualified name, and lists all the types contained in the specified assembly. Дополнительные сведения о получении полного имени сборки см. в разделе имена сборок.For information about how to obtain the fully qualified assembly name, see Assembly Names.

using namespace System;
using namespace System::Collections;
using namespace System::Reflection;
int main()
{
    // You must supply a valid fully qualified assembly name.            
    Assembly^ SampleAssembly = Assembly::Load
        ( "SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3" );
    array<Type^>^ Types = SampleAssembly->GetTypes();
    
    // Display all the types contained in the specified assembly.
    IEnumerator^ myEnum = Types->GetEnumerator();
    Type^ oType;
    while ( myEnum->MoveNext() )
    {
        oType = safe_cast<Type^>(myEnum->Current);
        Console::WriteLine( oType->Name );
    }
}

using System;
using System.Reflection;

class Class1
{
    public static void Main()
    {
        // You must supply a valid fully qualified assembly name.            
        Assembly SampleAssembly = Assembly.Load
            ("SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3");
        // Display all the types contained in the specified assembly.
        foreach (Type oType in SampleAssembly.GetTypes()) {
            Console.WriteLine(oType.Name);
        }
    }
}
Imports System.Reflection

Class Class1
    Public Shared Sub Main()
        ' You must supply a valid fully qualified assembly name.            
        Dim SampleAssembly As [Assembly] = _
            [Assembly].Load("SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3")
        Dim oType As Type
        ' Display all the types contained in the specified assembly.
        For Each oType In SampleAssembly.GetTypes()
            Console.WriteLine(oType.Name)
        Next oType
    End Sub	'LoadSample
End Class

Комментарии

Чтобы загрузить правильную сборку, рекомендуется вызвать метод Load, передав длинную форму имени сборки.To load the correct assembly, it's recommended to call the Load method by passing the long form of the assembly name. Длинная форма имени сборки состоит из его простого имени (например, "System" для сборки System. dll), а также версии, языка и региональных параметров, токена открытого ключа и, при необходимости, его архитектуры процессора.The long form of an assembly name consists of its simple name (such as "System" for the System.dll assembly) along with its version, culture, public key token, and optionally its processor architecture. Он соответствует свойству FullName сборки.It corresponds to the assembly's FullName property. В следующем примере показано использование длинного имени для загрузки сборки System. dll для .NET Framework 4:The following example illustrates the use of a long name to load the System.dll assembly for the .NET Framework 4:

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      string longName = "system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089";
      Assembly assem = Assembly.Load(longName);
      if (assem == null)
         Console.WriteLine("Unable to load assembly...");
      else
         Console.WriteLine(assem.FullName);
   }
}
// The example displays the following output:
//        system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
Imports System.Reflection

Module Example
   Public Sub Main()
      Dim longName As String = "system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
      Dim assem As Assembly = Assembly.Load(longName)
      If assem Is Nothing Then
         Console.WriteLine("Unable to load assembly...")
      Else
         Console.WriteLine(assem.FullName)
      End If
   End Sub
End Module
' The example displays the following output:
'       system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

FileLoadException возникает, если assemblyString задает полное имя сборки, а первая сборка, которая соответствует простому имени, имеет другую версию, язык и региональные параметры или маркер открытого ключа.FileLoadException is thrown if assemblyString specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. Загрузчик не продолжает поиск других сборок, соответствующих простому имени.The loader does not continue probing for other assemblies that match the simple name.

От свидетельства зависит, предоставляются ли сборке определенные разрешения.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:

  • При использовании метода Load без параметра Evidence сборка загружается с свидетельством, которое предоставляет загрузчик.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • При использовании метода Load с параметром Evidence объединяются части свидетельств.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Части свидетельства, предоставленные в качестве аргумента методу Load, заменяют части свидетельств, предоставляемые загрузчиком.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • При использовании перегрузки метода Load с параметром Byte[] для загрузки образа в формате COFF, свидетельство наследуется от вызывающей сборки.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Это относится к .NET Framework версии 1,1 с пакетом обновления 1 (SP1) и последующим выпускам.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Примечание

    В .NET Framework версии 1,0 и в версии 1,1 без SP1 при использовании перегрузки метода Load с параметром Byte[] для загрузки образа COFF свидетельство сочетается.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url и Site наследуются от вызывающей сборки, а Hash и StrongName берутся из сборки COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • При использовании метода Load с параметром Byte[] и Evidence для загрузки образа COFF используется только предоставляемое свидетельство.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Свидетельство вызывающей сборки и свидетельство образа COFF игнорируются.Evidence of the calling assembly and evidence of the COFF image is ignored.

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

В .NET Framework версии 2,0 архитектура процессора добавляется в удостоверение сборки и может быть указана в качестве части строк имен сборок.In the .NET Framework version 2.0, processor architecture is added to assembly identity, and can be specified as part of assembly name strings. Например, "ProcessorArchitecture = MSIL".For example, "ProcessorArchitecture=msil". Однако рекомендуемый способ указания имени сборки — создать объект AssemblyName и передать его в соответствующую перегрузку метода Load.However, the recommended way to specify an assembly name is to create an AssemblyName object and pass it to an appropriate overload of the Load method. См. раздел AssemblyName.ProcessorArchitecture.See AssemblyName.ProcessorArchitecture.

Безопасность

SecurityPermission
для загрузки сборки с свидетельством.to load an assembly with evidence. Связанное перечисление: ControlEvidenceAssociated enumeration: ControlEvidence

Дополнительно

Load(AssemblyName)

Загружает сборку с заданным именем AssemblyName.Loads an assembly given its AssemblyName.

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef);
public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef);
static member Load : System.Reflection.AssemblyName -> System.Reflection.Assembly
Public Shared Function Load (assemblyRef As AssemblyName) As Assembly

Параметры

assemblyRef
AssemblyName

Объект, описывающий загружаемую сборку.The object that describes the assembly to be loaded.

Возвраты

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

Исключения

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

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

Вместо этого в .NET для приложений Магазина Windows или в переносимой библиотеке классов перехватите исключение базового класса IOException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

Не удалось загрузить файл, который был найден.A file that was found could not be loaded.

- или --or-

assemblyRef указывает на удаленную сборку, но возможность выполнения кода в удаленных сборках отключена.assemblyRef specifies a remote assembly, but the ability to execute code in remote assemblies is disabled. См. элемент <loadFromRemoteSources>.See <loadFromRemoteSources>.

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

Примеры

В следующем примере создается экземпляр объекта AssemblyName, который используется для загрузки sysglobal.dll сборки.The following example instantiates an AssemblyName object and uses it to load the sysglobal.dll assembly. Затем в примере отображается полное имя открытых типов сборки.The example then displays the full name of the assembly's public types.

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      String fullName = "sysglobl, Version=4.0.0.0, Culture=neutral, " +
                        "PublicKeyToken=b03f5f7f11d50a3a, processor architecture=MSIL";
      var an = new AssemblyName(fullName);
      var assem = Assembly.Load(an);
      Console.WriteLine("Public types in assembly {0}:", assem.FullName);
      foreach (var t in assem.GetTypes())
         if (t.IsPublic)
            Console.WriteLine("   {0}", t.FullName);
   }
}
// The example displays the following output:
//   Public types in assembly sysglobl, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a:
//      System.Globalization.CultureAndRegionInfoBuilder
//      System.Globalization.CultureAndRegionModifiers
Imports System.Reflection

Module Example
   Public Sub Main()
      Dim fullName As String = "sysglobl, Version=4.0.0.0, Culture=neutral, " +
                               "PublicKeyToken=b03f5f7f11d50a3a, processor architecture=MSIL"
      Dim an As New AssemblyName(fullName)
      Dim assem As Assembly = Assembly.Load(an)
      Console.WriteLine("Public types in assembly {0}:", assem.FullName)
      For Each t As Type in assem.GetTypes()
         If t.IsPublic Then Console.WriteLine("   {0}", t.FullName)
      Next
   End Sub
End Module
' The example displays the following output:
'   Public types in assembly sysglobl, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a:
'      System.Globalization.CultureAndRegionInfoBuilder
'      System.Globalization.CultureAndRegionModifiers

Комментарии

FileLoadException возникает, если assemblyRef указывает полное имя сборки, а первая сборка, которая соответствует простому имени, имеет другую версию, язык и региональные параметры или маркер открытого ключа.FileLoadException is thrown if assemblyRef specifies the full assembly name and the first assembly that matches the simple name has a different version, culture, or public key token. Загрузчик не продолжает поиск других сборок, соответствующих простому имени.The loader does not continue probing for other assemblies that match the simple name. Начиная с .NET Framework 4, поскольку выполнение кода в удаленных сборках по умолчанию отключено, FileLoadException также создается, если assemblyRef указывает удаленную сборку.Starting with .NET Framework 4, because execution of code in remote assemblies is disabled by default, a FileLoadException is also thrown if assemblyRef specifies a remote assembly. Чтобы разрешить выполнение кода, загруженного из удаленных расположений, можно использовать элемент конфигурации <loadFromRemoteSources> .To enable execution of code loaded from remote locations, you can use the <loadFromRemoteSources> configuration element.

Примечание

Не используйте AssemblyName только с установленным свойством CodeBase.Do not use an AssemblyName with only the CodeBase property set. Свойство CodeBase не предоставляет никаких элементов удостоверения сборки (например, имени или версии), поэтому загрузка не происходит в соответствии с правилами загрузки по идентификатору, как и при ожидании от метода Load.The CodeBase property does not supply any elements of the assembly identity (such as name or version), so loading does not occur according to load-by-identity rules, as you would expect from the Load method. Вместо этого сборка загружается с помощью правил загрузки.Instead, the assembly is loaded using load-from rules. Сведения о недостатках использования контекста загрузки см. в разделе перегрузка метода Assembly.LoadFrom или рекомендации по загрузке сборки.For information about the disadvantages of using the load-from context, see the Assembly.LoadFrom method overload or Best Practices for Assembly Loading.

От свидетельства зависит, предоставляются ли сборке определенные разрешения.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:

  • При использовании метода Load без параметра Evidence сборка загружается с свидетельством, которое предоставляет загрузчик.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • При использовании метода Load с параметром Evidence объединяются части свидетельств.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Части свидетельства, предоставленные в качестве аргумента методу Load, заменяют части свидетельств, предоставляемые загрузчиком.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • При использовании перегрузки метода Load с параметром Byte[] для загрузки образа в формате COFF, свидетельство наследуется от вызывающей сборки.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Это относится к .NET Framework версии 1,1 с пакетом обновления 1 (SP1) и последующим выпускам.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Примечание

    В .NET Framework версии 1,0 и в версии 1,1 без SP1 при использовании перегрузки метода Load с параметром Byte[] для загрузки образа COFF свидетельство сочетается.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url и Site наследуются от вызывающей сборки, а Hash и StrongName берутся из сборки COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • При использовании метода Load с параметром Byte[] и Evidence для загрузки образа COFF используется только предоставляемое свидетельство.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Свидетельство вызывающей сборки и свидетельство образа COFF игнорируются.Evidence of the calling assembly and evidence of the COFF image is ignored.

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

Примечание

Если заданы и свойство AssemblyName.Name, и свойство AssemblyName.CodeBase, первая попытка загрузки сборки использует отображаемое имя (включая версию, культуру и т. д.), возвращенное свойством Assembly.FullName).If both the AssemblyName.Name property and the AssemblyName.CodeBase property are set, the first attempt to load the assembly uses the display name (including version, culture, and so on, as returned by the Assembly.FullName property). Если файл не найден, CodeBase используется для поиска сборки.If the file is not found, CodeBase is used to search for the assembly. Если сборка найдена с помощью CodeBase, отображаемое имя сопоставляется со сборкой.If the assembly is found using CodeBase, the display name is matched against the assembly. Если сопоставление завершается неудачей, выдается FileLoadException.If the match fails, a FileLoadException is thrown.

Безопасность

FileIOPermission
для доступа к чтению из файла или каталога, а также для доступа к данным в самом пути.for access to read from a file or directory, and for access to the information in the path itself. Связанные перечисления: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

WebPermission
для чтения URI, который не начинается с "file://".for reading a URI that does not begin with "file://".

SecurityPermission
для загрузки сборки с свидетельством.to load an assembly with evidence. Связанное перечисление: ControlEvidenceAssociated enumeration: ControlEvidence

Дополнительно

Load(Byte[], Byte[])

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

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

Параметры

rawAssembly
Byte[]

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

rawSymbolStore
Byte[]

Массив байтов, содержащий необработанные байты, которые представляют символы для сборки.A byte array that contains the raw bytes representing the symbols for the assembly.

Возвраты

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

Исключения

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

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.

Комментарии

Уровень доверия сборки, загружаемой с помощью этого метода, совпадает с уровнем доверия вызывающей сборки.The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. Чтобы загрузить сборку из массива байтов с уровнем доверия домена приложения, используйте перегрузку метода Load(Byte[], Byte[], SecurityContextSource).To load an assembly from a byte array with the trust level of the application domain, use the Load(Byte[], Byte[], SecurityContextSource) method overload. Дополнительные сведения об использовании свидетельств с перегрузками метода Load, принимающего байтовые массивы, см. в описании перегрузки метода Load(Byte[], Byte[], Evidence).For more information about the use of evidence with overloads of the Load method that take byte arrays, see the Load(Byte[], Byte[], Evidence) method overload.

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

Обратите внимание, что эта перегрузка метода всегда создает новый объект Assembly с собственным сопоставлением.Note that this method overload always creates a new Assembly object with its own mapping.

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