Assembly.Load Metoda

Definice

Obor názvů:

System.Reflection

Sestavení:

System.Runtime.dll

Načte sestavení.

Přetížení

Load(Byte[])	Načte sestavení s obrázkem založeným na formátu COFF (Common Object File Format), který obsahuje generované sestavení.
Load(String)	Načte sestavení se zadaným názvem.
Load(AssemblyName)	Načte sestavení vzhledem k jeho AssemblyName.
Load(Byte[], Byte[])	Načte sestavení s obrázkem založeným na formátu COFF (Common Object File Format), který obsahuje generované sestavení, volitelně včetně symbolů pro sestavení.

Load(Byte[])

Zdroj:

Assembly.cs

Načte sestavení bitové kopie založené na formátu COFF (Common Object File Format), která obsahuje vygenerované sestavení.

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

Parametry

rawAssembly

Byte[]

Bajtové pole, které je bitovou kopií založenou na coff obsahující generované sestavení.

Návraty

Assembly

Načtení sestavení.

Výjimky

ArgumentNullException

rawAssembly je null.

BadImageFormatException

rawAssembly není platné sestavení pro aktuálně načtený modul runtime.

Poznámky

Toto přetížení metody vždy vytvoří nový Assembly objekt ve vlastním kontextu izolovaného zatížení.

Pouze rozhraní .NET Framework: Úroveň důvěryhodnosti sestavení, která je načtena pomocí této metody je stejná jako úroveň důvěryhodnosti volajícího sestavení. Chcete-li načíst sestavení z pole bajtů s úrovní důvěryhodnosti domény aplikace, použijte Load(Byte[], Byte[], SecurityContextSource) přetížení metody. Další informace o použití důkazů s přetížením Load metody, které přebírají pole bajtů, naleznete v Load(Byte[], Byte[], Evidence) přetížení metody.

Load(String)

Zdroj:

Assembly.CoreCLR.cs

Načte sestavení se zadaným názvem.

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

Parametry

assemblyString

String

Dlouhá nebo krátká forma názvu sestavení.

Návraty

Assembly

Načtení sestavení.

Výjimky

ArgumentNullException

assemblyString je null.

ArgumentException

assemblyString je řetězec nulové délky.

FileNotFoundException

assemblyString nebyla nalezena.

FileLoadException

Nalezený soubor nelze načíst.

BadImageFormatException

assemblyString není platné sestavení pro aktuálně načtený modul runtime.

Příklady

Následující příklad načte sestavení s úplným názvem a vypíše všechny typy obsažené v zadaném sestavení. Informace o tom, jak získat plně kvalifikovaný název sestavení naleznete v části Názvy sestavení.

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

Poznámky

Chcete-li načíst správné sestavení, doporučuje se volat metodu Load předáním dlouhého tvaru názvu sestavení. Dlouhá forma názvu sestavení se skládá z jeho jednoduchého názvu (například "Systém" pro sestavení System.dll) a jeho verze, jazykové verze, tokenu veřejného klíče a volitelně architektury procesoru. Odpovídá vlastnosti sestavení FullName . Následující příklad ukazuje použití dlouhého názvu k načtení System.dll sestavení pro rozhraní .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 vyvolá se, pokud assemblyString určuje úplný název sestavení a první sestavení, které odpovídá jednoduchému názvu, má jinou verzi, jazykovou verzi nebo token veřejného klíče. Zavaděč nepokračuje ve sondování pro jiná sestavení, která odpovídají jednoduchému názvu.

Ve verzi 2.0 rozhraní.NET Framework je do identity sestavení přidána architektura procesoru a lze ji uvádět jako součást řetězců názvů sestavení. Příklad: "ProcessorArchitecture = msil". Doporučeným způsobem určení názvu sestavení je však vytvoření objektu AssemblyName a jeho předání příslušnému přetížení Load metody. Viz třída AssemblyName.ProcessorArchitecture.

Viz také

• AssemblyName
• LoadFrom(String)
• Jak běhové prostředí vyhledává sestavení

Load(AssemblyName)

Zdroj:

Assembly.CoreCLR.cs

Načte sestavení vzhledem k jeho 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

Parametry

assemblyRef

AssemblyName

Objekt, který popisuje sestavení, které má být načteno.

Návraty

Assembly

Načtení sestavení.

Výjimky

ArgumentNullException

assemblyRef je null.

FileNotFoundException

assemblyRef nebyla nalezena.

FileLoadException

Nalezený soubor nelze načíst.

-nebo-

Pouze rozhraní .NET Framework: assemblyRef Určuje umístění, které je zakázáno na <základě loadFromRemoteSources>.

Poznámka: V .NET pro aplikace pro Windows Store nebo v knihovně přenosných tříd místo toho zachyťte výjimku IOExceptionzákladní třídy .

BadImageFormatException

assemblyRef není platné sestavení pro aktuálně načtený modul runtime.

Příklady

Následující příklad vytvoří instanci objektu AssemblyName a použije ji k načtení sysglobal.dll sestavení. Příklad pak zobrazí úplný název veřejných typů sestavení.

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

Poznámky

FileLoadException vyvolá se, pokud assemblyRef určuje úplný název sestavení a první sestavení, které odpovídá jednoduchému názvu, má jinou verzi, jazykovou verzi nebo token veřejného klíče. Zavaděč nepokračuje ve sondování pro jiná sestavení, která odpovídají jednoduchému názvu.

Pouze rozhraní .NET Framework: Viz <loadFromRemoteSources> načítání sestavení ze vzdálených umístění.

Poznámka

Pouze rozhraní .NET Framework: Nepoužívejte vlastnost AssemblyName pouze s nastavenou CodeBase vlastností. Vlastnost CodeBase neposkytuje žádné prvky identity sestavení (například název nebo verzi), takže k načítání nedojde podle pravidel load-by-identity, jak byste očekávali Load od metody. Místo toho se sestavení načte pomocí pravidel načítání. Informace o nevýhodách použití kontextu načítání najdete v Assembly.LoadFrom tématu Přetížení metody nebo Osvědčené postupy pro načítání sestavení.

Poznámka

Pouze rozhraní .NET Framework: Pokud je vlastnost i AssemblyName.NameAssemblyName.CodeBase vlastnost nastavena, při prvním pokusu o načtení sestavení se použije zobrazovaný název (včetně verze, jazykové verze atd., které vrátí Assembly.FullName vlastnost). Pokud soubor není nalezen, CodeBase slouží k vyhledání sestavení. Pokud je sestavení nalezeno pomocí CodeBasepříkazu , bude zobrazovaný název porovnáván se sestavením. Pokud se shoda nezdaří, vyvolá se FileLoadException .

Viz také

• AssemblyName
• Jak běhové prostředí vyhledává sestavení

Load(Byte[], Byte[])

Zdroj:

Assembly.cs

Načte sestavení pomocí bitové kopie založené na formátu COFF (Common Object File Format) obsahující vygenerované sestavení, volitelně včetně symbolů pro sestavení.

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

Parametry

rawAssembly

Byte[]

Bajtové pole, které je bitovou kopií založenou na coff obsahující generované sestavení.

rawSymbolStore

Byte[]

Bajtové pole, které obsahuje nezpracované bajty představující symboly pro sestavení.

Návraty

Assembly

Načtení sestavení.

Výjimky

ArgumentNullException

rawAssembly je null.

BadImageFormatException

rawAssembly není platné sestavení pro aktuálně načtený modul runtime.

Poznámky

Toto přetížení metody vždy vytvoří nový Assembly objekt ve vlastním kontextu izolovaného zatížení.

Pouze rozhraní .NET Framework: Úroveň důvěryhodnosti sestavení, která je načtena pomocí této metody je stejná jako úroveň důvěryhodnosti volajícího sestavení. Chcete-li načíst sestavení z pole bajtů s úrovní důvěryhodnosti domény aplikace, použijte Load(Byte[], Byte[], SecurityContextSource) přetížení metody. Další informace o použití důkazů s přetížením Load metody, které přebírají pole bajtů, naleznete v Load(Byte[], Byte[], Evidence) přetížení metody.