Assembly.Load Metodo

Definizione

Spazio dei nomi:

System.Reflection

Assembly:

System.Runtime.dll

Carica un assembly.

Overload

Load(Byte[])	Carica l'assembly con un'immagine in formato COFF (Common Object File Format) contenente un assembly generato.
Load(String)	Carica un assembly con il nome specificato.
Load(AssemblyName)	Carica un assembly dato il relativo oggetto AssemblyName.
Load(Byte[], Byte[])	Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly generato e include facoltativamente i simboli per l'assembly.

Load(Byte[])

Origine:

Assembly.cs

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

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

Parametri

rawAssembly

Byte[]

Matrice di byte costituita da un'immagine in formato COFF contenente un assembly generato.

Restituisce

Assembly

Assembly caricato.

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 usando 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 di prove con overload del Load metodo che accettano 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 estesa o breve del nome dell'assembly.

Restituisce

Assembly

Assembly caricato.

Eccezioni

ArgumentNullException

assemblyString è null.

ArgumentException

assemblyString è una stringa di lunghezza zero.

FileNotFoundException

assemblyString non trovata.

FileLoadException

Non è stato possibile caricare un file trovato.

BadImageFormatException

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

Esempio

Nell'esempio seguente viene caricato un assembly con il nome completo e vengono elencati tutti i tipi contenuti nell'assembly specificato. Per informazioni su come ottenere il nome dell'assembly completo, vedere Nomi di 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

Commenti

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

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

Vedi anche

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

Load(AssemblyName)

Origine:

Assembly.CoreCLR.cs

Carica un assembly dato il relativo oggetto 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

Parametri

assemblyRef

AssemblyName

Oggetto che descrive l'assembly da caricare.

Restituisce

Assembly

Assembly caricato.

Eccezioni

ArgumentNullException

assemblyRef è null.

FileNotFoundException

assemblyRef non trovata.

FileLoadException

Non è stato possibile caricare un file trovato.

-oppure-

Solo .NET Framework: assemblyRef specifica un percorso disabilitato in base al <caricamentoFromRemoteSources>.

Nota: in .NET per le app di Windows Store o la libreria di classi portabili, rilevare 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 la usa 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

FileLoadException viene generato se assemblyRef specifica il nome completo dell'assembly e il primo assembly corrispondente al nome semplice ha una versione diversa, impostazioni cultura o token di chiave pubblica. Il caricatore non continua a eseguire il test per altri assembly che corrispondono al nome semplice.

Solo .NET Framework: Vedere <loadFromRemoteSources> per il caricamento di assembly da posizioni remote.

Nota

Solo .NET Framework: Non usare un AssemblyName oggetto con solo il set di CodeBase proprietà. La CodeBase proprietà non fornisce alcun elemento dell'identità dell'assembly (ad esempio nome o versione), quindi il caricamento non si verifica in base alle regole load-by-identity, come si prevede dal Load metodo. L'assembly viene invece caricato usando regole di caricamento. Per informazioni sugli svantaggi dell'uso del contesto di caricamento, vedere l'overload Assembly.LoadFrom del metodo o le procedure consigliate per il caricamento degli assembly.

Nota

Solo .NET Framework: Se sia la AssemblyName.Name proprietà che la AssemblyName.CodeBase proprietà sono impostate, 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 corrispondente all'assembly. Se la corrispondenza ha esito negativo, viene generata una FileLoadException classe.

Vedi anche

• AssemblyName
• Come il runtime individua gli assembly

Load(Byte[], Byte[])

Origine:

Assembly.cs

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly generato e include facoltativamente i simboli per l'assembly.

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

Parametri

rawAssembly

Byte[]

Matrice di byte costituita da un'immagine in formato 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.

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 usando 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 di prove con overload del Load metodo che accettano matrici di byte, vedere l'overload del Load(Byte[], Byte[], Evidence) metodo.