Assembly.Load Метод

Определение

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

System.Reflection

Сборка:

System.Runtime.dll

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

Перегрузки

Load(Byte[])	Загружает сборку с образом в формате COFF, содержащим порожденную сборку.
Load(String)	Загружает сборку с указанным именем.
Load(AssemblyName)	Загружает сборку с заданным именем AssemblyName.
Load(Byte[], Byte[])	Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и (дополнительно) символы для сборки.

Load(Byte[])

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

Assembly.cs

Загружает сборку с образом в формате COFF, содержащим порожденную сборку.

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, содержащим созданную сборку.

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

Assembly

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

Исключения

ArgumentNullException

rawAssembly имеет значение null.

BadImageFormatException

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

Комментарии

Эта перегрузка метода всегда создает новый Assembly объект в собственном изолированном контексте загрузки.

Только .NET Framework: Уровень доверия сборки, загружаемой с помощью этого метода, совпадает с уровнем доверия вызывающей сборки. Чтобы загрузить сборку из массива байтов с уровнем доверия домена приложения, используйте перегрузку Load(Byte[], Byte[], SecurityContextSource) метода . Дополнительные сведения об использовании свидетельства с перегрузками Load метода, которые принимают массивы байтов, см. в разделе Перегрузка Load(Byte[], Byte[], Evidence) метода.

Load(String)

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

Assembly.CoreCLR.cs

Загружает сборку с указанным именем.

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

Длинная или короткая форма имени сборки.

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

Assembly

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

Исключения

ArgumentNullException

assemblyString имеет значение null.

ArgumentException

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

FileNotFoundException

assemblyString не найден.

FileLoadException

Не удалось загрузить файл, который был найден.

BadImageFormatException

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

Примеры

В следующем примере сборка загружается с учетом ее полного имени и перечисляются все типы, содержащиеся в указанной сборке. Сведения о том, как получить полное имя сборки, см. в разделе Имена сборок.

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 метод , передав длинную форму имени сборки. Длинная форма имени сборки состоит из простого имени (например, System для сборки System.dll), а также версии, языка и региональных параметров, маркера открытого ключа и, при необходимости, архитектуры процессора. Он соответствует свойству сборки FullName . В следующем примере показано использование длинного имени для загрузки сборки System.dll для .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 указывает полное имя сборки, а первая сборка, соответствующая простому имени, имеет другую версию, язык и региональные параметры или маркер открытого ключа. Загрузчик не продолжает поиск других сборок, соответствующих простому имени.

В .NET Framework версии 2.0 архитектура процессора добавляется в удостоверение сборки и может быть указана как часть строк имени сборки. Например, "ProcessorArchitecture=msil". Однако для указания имени сборки рекомендуется создать AssemblyName объект и передать его в соответствующую перегрузку Load метода . См. раздел AssemblyName.ProcessorArchitecture.

См. также раздел

• AssemblyName
• LoadFrom(String)
• Обнаружение сборок в среде выполнения

Load(AssemblyName)

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

Assembly.CoreCLR.cs

Загружает сборку с заданным именем 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

Объект, описывающий загружаемую сборку.

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

Assembly

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

Исключения

ArgumentNullException

assemblyRef имеет значение null.

FileNotFoundException

assemblyRef не найден.

FileLoadException

Не удалось загрузить файл, который был найден.

-или-

Только .NET Framework: assemblyRef указывает расположение, которое отключено на <основе loadFromRemoteSources>.

Примечание. В .NET для приложений Магазина Windows или переносимой библиотеки классов перехватите исключение базового класса , IOException.

BadImageFormatException

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

Примеры

В следующем примере создается AssemblyName экземпляр объекта и он используется для загрузки сборки sysglobal.dll . Затем в примере отображается полное имя открытых типов сборки.

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

Только .NET Framework: См <loadFromRemoteSources> . сведения о загрузке сборок из удаленных расположений.

Примечание

Только .NET Framework: Не используйте с набором AssemblyNameCodeBase только свойств. Свойство CodeBase не предоставляет никаких элементов удостоверения сборки (например, имя или версия), поэтому загрузка не выполняется в соответствии с правилами загрузки по удостоверению, как и ожидалось в методе Load . Вместо этого сборка загружается с помощью правил загрузки из. Сведения о недостатках использования контекста загрузки из см. в статье Перегрузка Assembly.LoadFrom метода или Рекомендации по загрузке сборок.

Примечание

Только .NET Framework:AssemblyName.Name Если свойство и AssemblyName.CodeBase свойство заданы, при первой попытке загрузить сборку используется отображаемое имя (включая версию, язык и региональные параметры и т. д., возвращаемое свойством Assembly.FullName ). Если файл не найден, CodeBase используется для поиска сборки. Если сборка найдена с помощью CodeBase, отображаемое имя сопоставляется со сборкой. Если совпадение завершается сбоем FileLoadException , возникает исключение .

См. также раздел

• AssemblyName
• Обнаружение сборок в среде выполнения

Load(Byte[], Byte[])

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

Assembly.cs

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

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, содержащим созданную сборку.

rawSymbolStore

Byte[]

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

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

Assembly

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

Исключения

ArgumentNullException

rawAssembly имеет значение null.

BadImageFormatException

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

Комментарии

Эта перегрузка метода всегда создает новый Assembly объект в собственном изолированном контексте загрузки.

Только .NET Framework: Уровень доверия сборки, загружаемой с помощью этого метода, совпадает с уровнем доверия вызывающей сборки. Чтобы загрузить сборку из массива байтов с уровнем доверия домена приложения, используйте перегрузку Load(Byte[], Byte[], SecurityContextSource) метода . Дополнительные сведения об использовании свидетельства с перегрузками Load метода, которые принимают массивы байтов, см. в разделе Перегрузка Load(Byte[], Byte[], Evidence) метода.