Assembly.Load Metodo

Definizione

Spazio dei nomi:

System.Reflection

Assembly:

netstandard.dll, System.Runtime.dll

Carica un assembly.

Overload

Nome	Descrizione
Load(Byte[])	Carica l'assembly con un'immagine basata su COFF (Common Object File Format) contenente un assembly generato.
Load(String)	Carica un assembly con il nome specificato.
Load(AssemblyName)	Carica un assembly in base al relativo AssemblyNameoggetto .
Load(Byte[], Byte[])	Carica l'assembly con un'immagine basata su COFF (Common Object File Format) contenente un assembly generato, inclusi facoltativamente i simboli per l'assembly.

Load(Byte[])

Origine:

Assembly.cs

Carica l'assembly con un'immagine basata su COFF (Common Object File Format) contenente un assembly generato.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")]
public static System.Reflection.Assembly Load(byte[] rawAssembly);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")>]
static member Load : byte[] -> System.Reflection.Assembly

Public Shared Function Load (rawAssembly As Byte()) As Assembly

Parametri

rawAssembly

Byte[]

Matrice di byte che è un'immagine basata su COFF contenente un assembly generato.

Restituisce

Assembly

Assembly caricato.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

ArgumentNullException

rawAssembly è null.

BadImageFormatException

rawAssembly non è un assembly valido per il runtime attualmente caricato.

Commenti

Questo overload del metodo crea sempre un nuovo Assembly oggetto nel proprio contesto di carico isolato.

Solo .NET Framework: Il livello di attendibilità di un assembly caricato tramite questo metodo corrisponde al livello di attendibilità dell'assembly chiamante. Per caricare un assembly da una matrice di byte con il livello di attendibilità del dominio applicazione, usare l'overload del Load(Byte[], Byte[], SecurityContextSource) metodo . Per altre informazioni sull'uso dell'evidenza con overload del Load metodo che accetta matrici di byte, vedere l'overload del Load(Byte[], Byte[], Evidence) metodo.

Load(String)

Origine:

Assembly.CoreCLR.cs

Carica un assembly con il nome specificato.

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

Parametri

assemblyString

String

Forma lunga o breve del nome dell'assembly.

Restituisce

Assembly

Assembly caricato.

Eccezioni

ArgumentNullException

assemblyString è null.

ArgumentException

assemblyString è una stringa di lunghezza zero.

FileNotFoundException

assemblyString non viene trovato.

FileLoadException

Impossibile caricare un file trovato.

BadImageFormatException

assemblyString non è un assembly valido per il runtime attualmente caricato.

Esempio

Nell'esempio seguente viene caricato un assembly in base al nome completo e vengono elencati tutti i tipi contenuti nell'assembly specificato. Per informazioni su come ottenere il nome completo dell'assembly, vedere Nomi assembly.

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

Commenti

In .NET Core/.NET 5+, l'assembly di destinazione verrà caricato nell'oggetto corrente AssemblyLoadContext o nel AssemblyLoadContext.CurrentContextualReflectionContext contesto, se impostato. Per altre informazioni sul caricamento di assembly, vedere Algoritmo di caricamento dell'assembly gestito.

Per caricare l'assembly corretto, è consigliabile chiamare il Load metodo passando il formato lungo del nome dell'assembly. La forma lunga di un nome di assembly è costituita dal nome semplice (ad esempio "System" per l'assembly System.dll) insieme alla versione, alle impostazioni cultura, al token di chiave pubblica e, facoltativamente, alla relativa architettura del processore. Corrisponde alla proprietà dell'assembly FullName . L'esempio seguente illustra l'uso di un nome lungo per caricare l'assembly System.dll per .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 viene generata se assemblyString specifica il nome completo dell'assembly e il primo assembly che corrisponde al nome semplice ha una versione diversa, impostazioni cultura o token di chiave pubblica. Il caricatore non continua a eseguire il probe per altri assembly che corrispondono al nome semplice.

In .NET Framework versione 2.0 l'architettura del processore viene aggiunta all'identità dell'assembly e può essere specificata come parte delle stringhe del nome dell'assembly. Ad esempio, "ProcessorArchitecture=msil". Tuttavia, il modo consigliato per specificare un nome di assembly consiste nel creare un AssemblyName oggetto e passarlo a un overload appropriato del Load metodo . Vedi AssemblyName.ProcessorArchitecture.

Vedi anche

• AssemblyName
• LoadFrom(String)
• Come il runtime individua gli assembly

Load(AssemblyName)

Origine:

Assembly.CoreCLR.cs

Carica un assembly in base al relativo AssemblyNameoggetto .

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

Parametri

assemblyRef

AssemblyName

Oggetto che descrive l'assembly da caricare.

Restituisce

Assembly

Assembly caricato.

Eccezioni

ArgumentNullException

assemblyRef è null.

FileNotFoundException

assemblyRef non viene trovato.

FileLoadException

Impossibile caricare un file trovato.

oppure

Solo .NET Framework: assemblyRef specifica un percorso disabilitato in base a <loadFromRemoteSources>.

Nota: in .NET per le app di Windows Store o nella libreria di classi portabile intercettare invece l'eccezione della classe di base, IOException, .

BadImageFormatException

assemblyRef non è un assembly valido per il runtime attualmente caricato.

Esempio

Nell'esempio seguente viene creata un'istanza di un AssemblyName oggetto e viene usata per caricare l'assembly sysglobal.dll . Nell'esempio viene quindi visualizzato il nome completo dei tipi pubblici dell'assembly.

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

Commenti

In .NET Core/.NET 5+, l'assembly di destinazione verrà caricato nell'oggetto corrente AssemblyLoadContext o nel AssemblyLoadContext.CurrentContextualReflectionContext contesto, se impostato. Per altre informazioni sul caricamento di assembly, vedere Algoritmo di caricamento dell'assembly gestito.

Annotazioni

Solo .NET Framework: Per informazioni sul caricamento di assembly da posizioni remote, vedere <loadFromRemoteSources>.

Annotazioni

Solo .NET Framework: Non utilizzare un oggetto AssemblyName con solo il set di CodeBase proprietà. La CodeBase proprietà non fornisce alcun elemento dell'identità dell'assembly (ad esempio nome o versione), pertanto il caricamento non viene eseguito in base alle regole di caricamento per identità, come previsto dal Load metodo . L'assembly viene invece caricato usando regole di caricamento. Per informazioni sugli svantaggi dell'uso del contesto di caricamento, vedere overload del metodo o Procedure consigliate per il Assembly.LoadFrom caricamento di assembly.

Annotazioni

Solo .NET Framework: Se vengono impostate sia la AssemblyName.Name proprietà che la AssemblyName.CodeBase proprietà , il primo tentativo di caricare l'assembly usa il nome visualizzato (inclusa la versione, le impostazioni cultura e così via, come restituito dalla Assembly.FullName proprietà ). Se il file non viene trovato, CodeBase viene usato per cercare l'assembly. Se l'assembly viene trovato usando CodeBase, il nome visualizzato viene confrontato con l'assembly. Se la corrispondenza ha esito negativo, viene generata un'eccezione FileLoadException .

Vedi anche

• AssemblyName
• Come il runtime individua gli assembly

Load(Byte[], Byte[])

Origine:

Assembly.cs

Carica l'assembly con un'immagine basata su COFF (Common Object File Format) contenente un assembly generato, inclusi facoltativamente i simboli per l'assembly.

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")]
public static System.Reflection.Assembly Load(byte[] rawAssembly, byte[]? rawSymbolStore);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")>]
static member Load : byte[] * byte[] -> System.Reflection.Assembly

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

Parametri

rawAssembly

Byte[]

Matrice di byte che è un'immagine basata su COFF contenente un assembly generato.

rawSymbolStore

Byte[]

Matrice di byte contenente i byte non elaborati che rappresentano i simboli per l'assembly.

Restituisce

Assembly

Assembly caricato.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

ArgumentNullException

rawAssembly è null.

BadImageFormatException

rawAssembly non è un assembly valido per il runtime attualmente caricato.

Commenti

In .NET Core/5+, l'assembly di destinazione viene caricato nell'oggetto corrente AssemblyLoadContext. Per altre informazioni sul caricamento di assembly, vedere Algoritmo di caricamento dell'assembly gestito.

Questo overload del metodo crea sempre un nuovo Assembly oggetto nel proprio contesto di carico isolato.

Solo .NET Framework: Il livello di attendibilità di un assembly caricato tramite questo metodo corrisponde al livello di attendibilità dell'assembly chiamante. Per caricare un assembly da una matrice di byte con il livello di attendibilità del dominio applicazione, usare l'overload del Load(Byte[], Byte[], SecurityContextSource) metodo . Per altre informazioni sull'uso dell'evidenza con overload del Load metodo che accetta matrici di byte, vedere l'overload del Load(Byte[], Byte[], Evidence) metodo.