Assembly.Load Metoda

Definice

Obor názvů:

System.Reflection

Sestavení:

System.Runtime.dll

Načte sestavení.

Přetížení

Load(Byte[])	Načte sestavení bitové kopie založené na formátu COFF (Common Object File Format), která obsahuje vygenerované 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í pomocí bitové kopie založené na formátu COFF (Common Object File Format) obsahující vygenerované sestavení, volitelně včetně symbolů pro sestavení.

Load(Byte[])

Zdroj:

Assembly.cs

Načte sestavení s obrázkem založeným na formátu COFF (Common Object File Format), který obsahuje generované 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 image založená 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

Přetížení této metody vždy vytvoří nový Assembly objekt ve vlastním izolovaném kontextu 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í. Pokud chcete 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ů, najdete v Load(Byte[], Byte[], Evidence) tématu 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 nebyl nalezen.

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ě kvalifikovaný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 tématu 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

Pokud chcete 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 System.dll sestavení) spolu s jeho verzí, jazykovou verzí, tokenem veřejného klíče a volitelně i architekturou procesoru. Odpovídá vlastnosti sestavení FullName . Následující příklad ukazuje použití dlouhého názvu k načtení sestavení System.dll 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 je vyvolán, 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, jak zadat název sestavení, je vytvořit AssemblyName objekt a předat ho Load příslušnému přetížení 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 nebyl nalezen.

FileLoadException

Nalezený soubor nelze načíst.

-nebo-

assemblyRef určuje vzdálené sestavení, ale možnost spouštění kódu ve vzdálených sestaveních je zakázána. Viz <loadFromRemoteSources>.

Poznámka: V .NET pro aplikace pro Windows Store nebo v přenosné knihovně 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 ho sysglobal.dll k načtení 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 je vyvolán, 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. Počínaje rozhraním .NET Framework 4, protože spuštění kódu ve vzdálených sestaveních je ve výchozím nastavení zakázáno, FileLoadException je vyvolán také, pokud assemblyRef určuje vzdálené sestavení. Pokud chcete povolit spouštění kódu načteného ze vzdálených umístění, můžete použít <loadFromRemoteSources> element configuration.

Poznámka

Nepoužívejte objekt AssemblyName pouze s nastavenou CodeBase vlastností. Vlastnost CodeBase neposkytuje žádné prvky identity sestavení (jako je název nebo verze), 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í z. Informace o nevýhodách použití kontextu načítání z najdete v Assembly.LoadFrom tématu Přetížení metody nebo Osvědčené postupy pro načítání sestavení.

Poznámka

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., jak vrátí Assembly.FullName vlastnost). Pokud soubor není nalezen, CodeBase slouží k vyhledání sestavení. Pokud je sestavení nalezeno pomocí CodeBase, je zobrazovaný název porovná se sestavením. Pokud se shoda nezdaří, vyvolá se FileLoadException hodnota .

Viz také

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

Load(Byte[], Byte[])

Zdroj:

Assembly.cs

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í.

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 image založená 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

Přetížení této metody vždy vytvoří nový Assembly objekt ve vlastním izolovaném kontextu 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í. Pokud chcete 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ů, najdete v Load(Byte[], Byte[], Evidence) tématu přetížení metody.