Assembly.Load Метод

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

Public Shared Function Load (rawAssembly As Byte(), rawSymbolStore As Byte(), securityContextSource As SecurityContextSource) As Assembly

Параметры

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

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

Исключения

Комментарии

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

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore, System::Security::Policy::Evidence ^ securityEvidence);

public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore, System.Security.Policy.Evidence securityEvidence);

[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 http://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

[<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 http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
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

Параметры

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

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

Атрибуты

ObsoleteAttribute

Исключения

Комментарии

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

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

От свидетельства зависит, предоставляются ли сборке определенные разрешения. Ниже приведены правила объединения сборок и доказательств безопасности.

• При использовании Load метода без Evidence параметра сборка загружается с свидетельством, которое предоставляет загрузчик.

• При использовании Load метода с параметром Evidence элементы свидетельства объединяются. Фрагменты доказательств, предоставленных в качестве аргумента методу Load , заменяют фрагменты доказательств, предоставленных загрузчиком.

• При использовании перегрузки Load метода с параметром Byte[] для загрузки образа COFF свидетельство наследуется от вызывающей сборки.

• При использовании Load метода с параметром Byte[] и Evidence для загрузки изображения COFF используется только предоставленное свидетельство. Свидетельство вызывающей сборки и свидетельство образа COFF игнорируются.

Если метод вызывается Load несколько раз в одной сборке, но с другим указанным свидетельством, среда CLR не создает исключение , FileLoadException так как невозможно определить равенство и целостность различных спецификаций свидетельства. Первое успешное свидетельство — это используемое доказательство.

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString, System::Security::Policy::Evidence ^ assemblySecurity);

public static System.Reflection.Assembly Load (string assemblyString, System.Security.Policy.Evidence assemblySecurity);

[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 http://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

[<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 http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member Load : string * System.Security.Policy.Evidence -> System.Reflection.Assembly

Public Shared Function Load (assemblyString As String, assemblySecurity As Evidence) As Assembly

Параметры

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

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

Атрибуты

ObsoleteAttribute

Исключения

Комментарии

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

От свидетельства зависит, предоставляются ли сборке определенные разрешения. Ниже приведены правила объединения сборок и доказательств безопасности.

• При использовании Load метода без Evidence параметра сборка загружается с свидетельством, которое предоставляет загрузчик.

• При использовании Load метода с параметром Evidence элементы свидетельства объединяются. Фрагменты доказательств, предоставленных в качестве аргумента методу Load , заменяют фрагменты доказательств, предоставленных загрузчиком.

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

• При использовании Load метода с параметром Byte[] и Evidence для загрузки изображения COFF используется только предоставленное свидетельство. Свидетельство вызывающей сборки и свидетельство образа COFF игнорируются.

Если этот метод вызывается несколько раз в одной и той же сборке, но с указанием другого свидетельства, среда CLR не создает исключение FileLoadException , так как невозможно определить равенство и целостность различных спецификаций свидетельства. Первое успешное свидетельство — это используемое доказательство.

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

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

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

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef, System::Security::Policy::Evidence ^ assemblySecurity);

public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef, System.Security.Policy.Evidence assemblySecurity);

[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 http://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

[<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 http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
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

Параметры

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

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

Атрибуты

ObsoleteAttribute

Исключения

Комментарии

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

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

От свидетельства зависит, предоставляются ли сборке определенные разрешения. Ниже приведены правила слияния сборок и свидетельств безопасности.

• При использовании Load метода без Evidence параметра сборка загружается с свидетельством, которое предоставляет загрузчик.

• При использовании Load метода с параметром Evidence элементы свидетельства объединяются. Фрагменты доказательств, предоставленных в качестве аргумента Load для метода, заменяют фрагменты доказательств, предоставленных загрузчиком.

• При использовании перегрузки Load метода с параметром Byte[] для загрузки изображения COFF свидетельство наследуется от вызывающей сборки.

• При использовании Load метода с параметром Byte[] и Evidence для загрузки изображения COFF используется только предоставленное свидетельство. Свидетельство вызывающей сборки и свидетельство образа COFF игнорируются.

Если метод вызывается Load несколько раз в одной сборке, но с другим указанным свидетельством, среда CLR не создает исключение , FileLoadException так как невозможно определить равенство и целостность различных спецификаций свидетельства. Свидетельством того, что первый успех выполнен, является свидетельство, которое используется.

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

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

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

Assembly.cs

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

Assembly.cs

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

Assembly.cs

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

Параметры

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

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

Исключения

Комментарии

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

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

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

Assembly.CoreCLR.cs

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

Assembly.CoreCLR.cs

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

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

Параметры

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

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

Исключения

Примеры

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

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)
• Обнаружение сборок в среде выполнения

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

Assembly.CoreCLR.cs

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

Assembly.CoreCLR.cs

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

Assembly.CoreCLR.cs

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

Параметры

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

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

Исключения

Примеры

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

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

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

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

Assembly.cs

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

Assembly.cs

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

Assembly.cs

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);

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

Параметры

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

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

Исключения

Комментарии

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

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