Assembly.Load Metoda

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

Parametry

Návraty

Načtení sestavení.

Výjimky

Poznámky

Sestavení se načte do domény aplikace volajícího pomocí zadaného zdroje pro kontext zabezpečení. Pokud rawSymbolStore byla zadána, načtou se také nezpracované bajty, které představují symboly pro sestavení.

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

Parametry

Návraty

Načtení sestavení.

Atributy

ObsoleteAttribute

Výjimky

Poznámky

Přetížení této metody vždy vytvoří nový Assembly objekt ve vlastním izolovaném kontextu zatížení.

Sestavení se načte pomocí poskytnutého důkazu. Načtou se také nezpracované bajty představující symboly pro sestavení.

To, zda jsou nebo nejsou udělena určitá oprávnění sestavení, je založeno na důkazech. Pravidla pro slučování důkazů o sestavení a zabezpečení jsou následující:

• Pokud použijete metodu Load bez Evidence parametru, sestavení je načteno s důkazy, které zavaděč poskytuje.

• Když použijete metodu Load s parametrem Evidence , části důkazů se sloučí. Důkazy poskytnuté jako argument metody Load nahrazují důkazy dodané zavaděčem.

• Pokud použijete Load přetížení metody s parametrem Byte[] pro načtení image COFF, zdědí se důkazy z volajícího sestavení.

• Pokud použijete metodu Load s parametrem Byte[] a Evidence k načtení image COFF, použije se pouze dodaný důkaz. Důkazy o volajícím sestavení a důkazy image COFF jsou ignorovány.

Pokud voláte metodu Load více než jednou ve stejném sestavení, ale se zadaným jiným důkazem, modul CLR (Common Language Runtime) nevyvolá FileLoadException chybu, protože nelze určit rovnost a integritu různých specifikací důkazů. Důkazy, které jsou nejprve úspěšné, jsou důkazy, které se používají.

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

Parametry

Návraty

Načtení sestavení.

Atributy

ObsoleteAttribute

Výjimky

Poznámky

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.

To, zda jsou nebo nejsou udělena určitá oprávnění sestavení, je založeno na důkazech. Pravidla pro slučování důkazů o sestavení a zabezpečení jsou následující:

• Pokud použijete metodu Load bez Evidence parametru, sestavení je načteno s důkazy, které zavaděč poskytuje.

• Když použijete metodu Load s parametrem Evidence , části důkazů se sloučí. Důkazy poskytnuté jako argument metody Load nahrazují důkazy dodané zavaděčem.

• Pokud použijete Load přetížení metody s parametrem Byte[] k načtení image COFF (Common Object File Format), důkazy jsou zděděny z volajícího sestavení.

• Pokud použijete metodu Load s parametrem Byte[] a Evidence k načtení image COFF, použije se pouze dodaný důkaz. Důkazy o volajícím sestavení a důkaz o obrázku COFF jsou ignorovány.

Pokud zavoláte tuto metodu více než jednou ve stejném sestavení, ale s jiným důkazy zadané, common language runtime nevyvolá FileLoadException chybu, protože rovnost a integritu různých specifikací důkazu nelze určit. Důkazy, které jsou nejprve úspěšné, jsou důkazy, které se používají.

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é

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

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

Parametry

Návraty

Načtení sestavení.

Atributy

ObsoleteAttribute

Výjimky

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.

Viz <loadFromRemoteSources> informace o načítání sestavení ze vzdálených umístění.

To, zda jsou určitá oprávnění udělena nebo nebyla udělena sestavení, je založena na důkazech. Pravidla pro slučování prostředků sestavení a zabezpečení jsou následující:

• Při použití Load metody bez Evidence parametru je sestavení načteno s důkazem, že zavaděč poskytuje.

• Když použijete metodu Load s parametrem Evidence , části důkazů se sloučí. Důkazy poskytnuté jako argument Load metody nahrazují důkazy dodané zavaděčem.

• Použijete-li Load přetížení metody s parametrem Byte[] k načtení bitové kopie COFF (Common Object File Format), důkazy jsou zděděny z volajícího sestavení.

• Když použijete metodu Load s parametrem Byte[] a Evidence k načtení image COFF, použije se pouze dodaný důkaz. Důkazy o volajícím sestavení a důkazy image COFF jsou ignorovány.

Pokud voláte metodu Load více než jednou ve stejném sestavení, ale s jiným důkazem zadaným, modul CLR (Common Language Runtime) nevyvolá FileLoadException výjimku , protože nelze určit rovnost a integritu různých specifikací důkazů. Důkazy, které jsou první úspěšné, jsou důkazy, které jsou použity.

Viz také

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

Zdroj:

Assembly.cs

Zdroj:

Assembly.cs

Zdroj:

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

Parametry

Návraty

Načtení sestavení.

Výjimky

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.

Zdroj:

Assembly.CoreCLR.cs

Zdroj:

Assembly.CoreCLR.cs

Zdroj:

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

Parametry

Návraty

Načtení sestavení.

Výjimky

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í

Zdroj:

Assembly.CoreCLR.cs

Zdroj:

Assembly.CoreCLR.cs

Zdroj:

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

Parametry

Návraty

Načtení sestavení.

Výjimky

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

Viz také

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

Zdroj:

Assembly.cs

Zdroj:

Assembly.cs

Zdroj:

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

Parametry

Návraty

Načtení sestavení.

Výjimky

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.