Assembly.Load Méthode

Définition

Espace de noms:

System.Reflection

Assemblys:

netstandard.dll, System.Runtime.dll

Charge un assembly.

Surcharges

Nom	Description
Load(Byte[])	Charge l’assembly avec une image COFF (Common Object File Format) contenant un assembly émis.
Load(String)	Charge un assembly avec le nom spécifié.
Load(AssemblyName)	Charge un assembly en fonction de son AssemblyName.
Load(Byte[], Byte[])	Charge l’assembly avec une image COFF (Common Object File Format) contenant un assembly émis, y compris éventuellement des symboles pour l’assembly.

Load(Byte[])

Source:

Assembly.cs

Charge l’assembly avec une image COFF (Common Object File Format) contenant un assembly émis.

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

Paramètres

rawAssembly

Byte[]

Tableau d’octets qui est une image basée sur COFF contenant un assembly émis.

Retours

Assembly

Assembly chargé.

Attributs

RequiresUnreferencedCodeAttribute

Exceptions

ArgumentNullException

rawAssembly a la valeur null.

BadImageFormatException

rawAssembly n’est pas un assembly valide pour le runtime actuellement chargé.

Remarques

Cette surcharge de méthode crée toujours un objet Assembly dans son propre contexte de charge isolé.

.NET Framework uniquement : Le niveau d’approbation d’un assembly chargé à l’aide de cette méthode est identique au niveau d’approbation de l’assembly appelant. Pour charger un assembly à partir d’un tableau d’octets avec le niveau d’approbation du domaine d’application, utilisez la Load(Byte[], Byte[], SecurityContextSource) surcharge de méthode. Pour plus d’informations sur l’utilisation de preuves avec des surcharges de la Load méthode qui acceptent des tableaux d’octets, consultez la Load(Byte[], Byte[], Evidence) surcharge de méthode.

Load(String)

Source:

Assembly.CoreCLR.cs

Charge un assembly avec le nom spécifié.

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

Paramètres

assemblyString

String

Forme longue ou courte du nom de l’assembly.

Retours

Assembly

Assembly chargé.

Exceptions

ArgumentNullException

assemblyString a la valeur null.

ArgumentException

assemblyString est une chaîne de longueur nulle.

FileNotFoundException

assemblyString n’est pas trouvé.

FileLoadException

Impossible de charger un fichier trouvé.

BadImageFormatException

assemblyString n’est pas un assembly valide pour le runtime actuellement chargé.

Exemples

L’exemple suivant charge un assembly en fonction de son nom complet et répertorie tous les types contenus dans l’assembly spécifié. Pour plus d’informations sur l’obtention du nom complet de l’assembly, consultez Noms d’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

Remarques

Dans .NET Core/.NET 5+, l’assembly cible est chargé dans le contexte actuel AssemblyLoadContext ou dans le AssemblyLoadContext.CurrentContextualReflectionContext contexte s’il est défini. Pour plus d’informations sur le chargement d’assembly, consultez l’algorithme de chargement d’assembly managé.

Pour charger l’assembly correct, il est recommandé d’appeler la Load méthode en passant la forme longue du nom de l’assembly. La forme longue d’un nom d’assembly se compose de son nom simple (tel que « System » pour l’assembly System.dll) ainsi que sa version, sa culture, son jeton de clé publique et éventuellement son architecture de processeur. Elle correspond à la propriété de l’assembly FullName . L’exemple suivant illustre l’utilisation d’un nom long pour charger l’assembly System.dll pour .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 est levée si assemblyString spécifie le nom complet de l’assembly, et le premier assembly qui correspond au nom simple a une autre version, culture ou jeton de clé publique. Le chargeur ne continue pas à rechercher d’autres assemblys qui correspondent au nom simple.

Dans .NET Framework version 2.0, l’architecture du processeur est ajoutée à l’identité d’assembly et peut être spécifiée dans le cadre de chaînes de nom d’assembly. Par exemple, « ProcessorArchitecture=msil ». Toutefois, la méthode recommandée pour spécifier un nom d’assembly consiste à créer un AssemblyName objet et à le transmettre à une surcharge appropriée de la Load méthode. Voir AssemblyName.ProcessorArchitecture.

Voir aussi

• AssemblyName
• LoadFrom(String)
• Comment le Runtime localise les assemblages

Load(AssemblyName)

Source:

Assembly.CoreCLR.cs

Charge un assembly en fonction de son 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

Paramètres

assemblyRef

AssemblyName

Objet qui décrit l’assembly à charger.

Retours

Assembly

Assembly chargé.

Exceptions

ArgumentNullException

assemblyRef a la valeur null.

FileNotFoundException

assemblyRef n’est pas trouvé.

FileLoadException

Impossible de charger un fichier trouvé.

- ou -

.NET Framework uniquement : assemblyRef spécifie un emplacement désactivé en <fonction de loadFromRemoteSources>.

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portables, interceptez l’exception de classe de base, à IOExceptionla place.

BadImageFormatException

assemblyRef n’est pas un assembly valide pour le runtime actuellement chargé.

Exemples

L’exemple suivant instancie un AssemblyName objet et l’utilise pour charger l’assembly sysglobal.dll . L’exemple affiche ensuite le nom complet des types publics de l’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

Remarques

Dans .NET Core/.NET 5+, l’assembly cible est chargé dans le contexte actuel AssemblyLoadContext ou dans le AssemblyLoadContext.CurrentContextualReflectionContext contexte s’il est défini. Pour plus d’informations sur le chargement d’assembly, consultez l’algorithme de chargement d’assembly managé.

Note

.NET Framework uniquement : Pour plus d’informations sur le chargement d’assemblys à partir d’emplacements distants, consultez <loadFromRemoteSources>.

Note

.NET Framework uniquement : N’utilisez pas d’élément AssemblyName avec uniquement le jeu de CodeBase propriétés. La CodeBase propriété ne fournit aucun élément de l’identité d’assembly (par exemple, le nom ou la version), le chargement ne se produit donc pas en fonction des règles de chargement par identité, comme vous l’attendiez de la Load méthode. Au lieu de cela, l’assembly est chargé à l’aide de règles de chargement. Pour plus d’informations sur les inconvénients liés à l’utilisation du contexte de chargement, consultez la Assembly.LoadFrom surcharge de méthode ou les meilleures pratiques pour le chargement d’assembly.

Note

.NET Framework uniquement : Si la AssemblyName.Name propriété et la AssemblyName.CodeBase propriété sont définies, la première tentative de chargement de l’assembly utilise le nom complet (y compris la version, la culture, etc., comme retourné par la Assembly.FullName propriété). Si le fichier est introuvable, CodeBase il est utilisé pour rechercher l’assembly. Si l’assembly est trouvé à l’aide CodeBase, le nom d’affichage est mis en correspondance avec l’assembly. Si la correspondance échoue, une FileLoadException valeur est levée.

Voir aussi

• AssemblyName
• Comment le Runtime localise les assemblages

Load(Byte[], Byte[])

Source:

Assembly.cs

Charge l’assembly avec une image COFF (Common Object File Format) contenant un assembly émis, y compris éventuellement des symboles pour 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

Paramètres

rawAssembly

Byte[]

Tableau d’octets qui est une image basée sur COFF contenant un assembly émis.

rawSymbolStore

Byte[]

Tableau d’octets qui contient les octets bruts représentant les symboles de l’assembly.

Retours

Assembly

Assembly chargé.

Attributs

RequiresUnreferencedCodeAttribute

Exceptions

ArgumentNullException

rawAssembly a la valeur null.

BadImageFormatException

rawAssembly n’est pas un assembly valide pour le runtime actuellement chargé.

Remarques

Dans .NET Core/5+, l’assembly cible est chargé dans le fichier actif AssemblyLoadContext. Pour plus d’informations sur le chargement d’assembly, consultez l’algorithme de chargement d’assembly managé.

Cette surcharge de méthode crée toujours un objet Assembly dans son propre contexte de charge isolé.

.NET Framework uniquement : Le niveau d’approbation d’un assembly chargé à l’aide de cette méthode est identique au niveau d’approbation de l’assembly appelant. Pour charger un assembly à partir d’un tableau d’octets avec le niveau d’approbation du domaine d’application, utilisez la Load(Byte[], Byte[], SecurityContextSource) surcharge de méthode. Pour plus d’informations sur l’utilisation de preuves avec des surcharges de la Load méthode qui acceptent des tableaux d’octets, consultez la Load(Byte[], Byte[], Evidence) surcharge de méthode.