AssemblyLoadContext AssemblyLoadContext AssemblyLoadContext AssemblyLoadContext Class

Definizione

Rappresenta il concetto di runtime di un ambito per l'associazione.Represents the runtime's concept of a scope for binding. Questa classe è astratta.This class is abstract.

public ref class AssemblyLoadContext abstract
public abstract class AssemblyLoadContext
type AssemblyLoadContext = class
Public MustInherit Class AssemblyLoadContext
Ereditarietà
AssemblyLoadContextAssemblyLoadContextAssemblyLoadContextAssemblyLoadContext

Commenti

AssemblyLoadContext Rappresenta un contesto di caricamento.The AssemblyLoadContext represents a load context. A livello concettuale, un contesto di caricamento crea un ambito per il caricamento, la risoluzione e potenzialmente lo scaricamento di un set di assembly.Conceptually, a load context creates a scope for loading, resolving, and potentially unloading a set of assemblies.

AssemblyLoadContext è una classe astratta.AssemblyLoadContext is an abstract class. AssemblyLoadContext.Load(AssemblyName) Deve essere implementato per creare una classe concreta.The AssemblyLoadContext.Load(AssemblyName) needs to be implemented to create a concrete class.

Esiste AssemblyLoadContext principalmente per fornire l'isolamento dell'associazione di assembly.The AssemblyLoadContext exists primarily to provide assembly binding isolation. Consente il caricamento di più versioni dello stesso assembly all'interno di un singolo processo.It allows multiple versions of the same assembly to be loaded within a single process. Sostituisce i meccanismi di isolamento forniti da più AppDomain istanze nel .NET Framework.It replaces the isolation mechanisms provided by multiple AppDomain instances in the .NET Framework.

Nota

AssemblyLoadContextnon fornisce funzionalità di sicurezza.AssemblyLoadContext does not provide any security features. Tutto il codice ha autorizzazioni complete per il processo.All code has full permissions of the process.

Utilizzo in fase di esecuzioneUsage in the runtime

Il runtime implementa due contesti di caricamento dell'assembly:The runtime implements two assembly load contexts:

Utilizzo dell'applicazioneApplication usage

Un'applicazione può crearne una AssemblyLoadContext propria per creare una soluzione personalizzata per scenari di associazione avanzati.An application can create its own AssemblyLoadContext to create a custom solution for advanced binding scenarios. La personalizzazione è incentrata sulla definizione dei meccanismi di risoluzione delle dipendenze.The customization focuses on defining dependency resolution mechanisms.

In AssemblyLoadContext sono disponibili due punti di estensione per implementare la risoluzione degli assembly gestiti:The AssemblyLoadContext provides two extension points to implement managed assembly resolution:

  1. Fornisce la prima possibilità per la AssemblyLoadContext risoluzione dell'assembly, il caricamento e la restituzione. AssemblyLoadContext.Load(AssemblyName)The AssemblyLoadContext.Load(AssemblyName) provides the first chance for the AssemblyLoadContext to resolve the assembly, load it and return it. AssemblyLoadContext.Load(AssemblyName) Se restituisce null, il caricatore tenterà di AssemblyLoadContext.Defaultcaricare l'assembly in.If the AssemblyLoadContext.Load(AssemblyName) returns null, the loader will try to load the assembly into the AssemblyLoadContext.Default.
  2. Se non AssemblyLoadContext è in grado di risolvere l'assembly, l'originale ottiene una seconda possibilità per risolvere l'assembly. AssemblyLoadContext.DefaultIf the AssemblyLoadContext.Default is unable to resolve the assembly, the original AssemblyLoadContext gets a second chance to resolve the assembly. Il runtime genera l' Resolving evento.The runtime raises the Resolving event.

Il AssemblyLoadContext.LoadUnmanagedDll(String) metodo virtuale consente inoltre di personalizzare la risoluzione predefinita degli assembly non gestiti.Additionally the AssemblyLoadContext.LoadUnmanagedDll(String) virtual method allows customization of the default unmanaged assembly resolution. L'implementazione predefinita restituisce null, che fa in modo che la ricerca di runtime usi i criteri di ricerca predefiniti, che è sufficiente per la maggior parte degli scenari.The default implementation returns null, which causes the runtime search to use its default search policy which is sufficient for most scenarios.

Problemi tecniciTechnical challenges

  • Non è possibile caricare più versioni del runtime in un singolo processo.It is not possible to load multiple versions of the runtime in a single process.

    Attenzione

    Il caricamento di più copie o versioni diverse degli assembly del Framework può comportare un comportamento imprevisto e difficile da diagnosticare.Loading multiple copies or different versions of framework assemblies can lead to unexpected and hard to diagnose behavior.

    Suggerimento

    Usare i limiti del processo con la comunicazione remota e/o interprocesso per risolvere questo problema di isolamento.Use process boundaries with remoting and/or interprocess communication to solve this isolation problem.

  • Il tempo di caricamento degli assembly può rendere difficoltoso il test e il debug.The timing of assembly loading can make testing and debugging difficult. Gli assembly vengono in genere caricati senza che le relative dipendenze vengano risolte immediatamente.Assemblies are typically loaded without their dependencies immediately being resolved. Le dipendenze vengono caricate in base alle esigenze:The dependencies are loaded as they are needed:

    • Quando il codice viene diramato in un assembly dipendente.When code branches into a dependent assembly.
    • Quando il codice carica le risorse.When code loads resources.
    • Quando il codice carica in modo esplicito gli assembly.When code explicitly loads assemblies.
  • L'implementazione di AssemblyLoadContext.Load(AssemblyName) può aggiungere nuove dipendenze che potrebbero dover essere isolate per consentire l'esistenza di versioni diverse.The implementation of AssemblyLoadContext.Load(AssemblyName) can add new dependencies which may need to be isolated to allow different versions to exist. L'implementazione più naturale inserirebbe queste dipendenze nel contesto predefinito.The most natural implementation would place these dependencies in the default context. Un'attenta progettazione può isolare le nuove dipendenze.Careful design can isolate the new dependencies.

  • Il processo di isolamento dell'associazione crea più tipi con lo stesso nome di tipo.The binding isolation process creates multiple types with the same type name.

    • Questo può causare la confusione dei messaggi di errore, ad esempio "non è possibile eseguire il cast del tipo Foo. foo al tipo Foo. foo".This can lead to confusing error messages, for example "type Foo.Foo cannot be cast to type Foo.Foo."
    • Il marshalling tra i limiti di isolamento non è semplice.Marshaling across isolation boundaries is non-trivial. Una soluzione tipica consiste nell'usare un'interfaccia definita in un assembly che viene caricata solo nel contesto di caricamento predefinito.A typical solution would be to use an interface defined in an assembly which is only loaded into the default load context.

Costruttori

AssemblyLoadContext() AssemblyLoadContext() AssemblyLoadContext() AssemblyLoadContext()

Inizializza una nuova istanza della classe AssemblyLoadContext.Initializes a new instance of the AssemblyLoadContext class.

AssemblyLoadContext(Boolean) AssemblyLoadContext(Boolean) AssemblyLoadContext(Boolean) AssemblyLoadContext(Boolean)

Inizializza una nuova istanza della classe AssemblyLoadContext con un valore che indica se è abilitato lo scaricamento.Initializes a new instance of the AssemblyLoadContext class with a value that indicates whether unloading is enabled.

AssemblyLoadContext(String, Boolean) AssemblyLoadContext(String, Boolean) AssemblyLoadContext(String, Boolean) AssemblyLoadContext(String, Boolean)

Inizializza una nuova istanza della classe AssemblyLoadContext con un nome e un valore che indicano se è abilitato lo scaricamento.Initializes a new instance of the AssemblyLoadContext class with a name and a value that indicates whether unloading is enabled.

Proprietà

All All All All

Restituisce una raccolta di tutte le istanze di AssemblyLoadContext.Returns a collection of all AssemblyLoadContext instances.

Assemblies Assemblies Assemblies Assemblies

Restituisce una raccolta delle istanze di Assembly caricate in AssemblyLoadContext.Returns a collection of the Assembly instances loaded in the AssemblyLoadContext.

CurrentContextualReflectionContext CurrentContextualReflectionContext CurrentContextualReflectionContext CurrentContextualReflectionContext

Ottiene l'elemento AssemblyLoadContext impostato dalla chiamata più recente a EnterContextualReflection().Gets the AssemblyLoadContext set by the most recent call to EnterContextualReflection().

Default Default Default Default

Ottiene l'elemento AssemblyLoadContext predefinito.Gets the default AssemblyLoadContext. Il contesto predefinito contiene l'assembly principale dell'applicazione e le relative dipendenze statiche.The default context contains the main application assembly and its static dependencies.

IsCollectible IsCollectible IsCollectible IsCollectible

Ottiene un valore che indica se AssemblyLoadContext è ritirabile.Gets a value that indicates whether this AssemblyLoadContext is collectible.

Name Name Name Name

Ottenere il nome di AssemblyLoadContext.Get the name of the AssemblyLoadContext.

Metodi

EnterContextualReflection() EnterContextualReflection() EnterContextualReflection() EnterContextualReflection()

Imposta CurrentContextualReflectionContext su thisAssemblyLoadContext.Sets CurrentContextualReflectionContext to thisAssemblyLoadContext.

EnterContextualReflection(Assembly) EnterContextualReflection(Assembly) EnterContextualReflection(Assembly) EnterContextualReflection(Assembly)

Imposta CurrentContextualReflectionContext sull'elemento AssemblyLoadContext che ha caricato l'assembly.Sets CurrentContextualReflectionContext to the AssemblyLoadContext which loaded the assembly.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Consente all'oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga recuperato da Garbage Collection.Allows the object to try to free resources and perform other cleanup operations before it's reclaimed by garbage collection.

GetAssemblyName(String) GetAssemblyName(String) GetAssemblyName(String) GetAssemblyName(String)

Ottiene un AssemblyName per un percorso di assembly.Gets an AssemblyName for an assembly path.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLoadContext(Assembly) GetLoadContext(Assembly) GetLoadContext(Assembly) GetLoadContext(Assembly)

Ottiene l'elemento AssemblyLoadContext contenente il valore Assembly specificato.Gets the AssemblyLoadContext containing the specified Assembly.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
Load(AssemblyName) Load(AssemblyName) Load(AssemblyName) Load(AssemblyName)

Quando sottoposto a override in una classe derivata, consente a un assembly di essere risolto e caricato in base al suo AssemblyName.When overridden in a derived class, allows an assembly to be resolved and loaded based on its AssemblyName.

LoadFromAssemblyName(AssemblyName) LoadFromAssemblyName(AssemblyName) LoadFromAssemblyName(AssemblyName) LoadFromAssemblyName(AssemblyName)

Risolve e carica un assembly dato il relativo oggetto AssemblyName.Resolves and loads an assembly given its AssemblyName.

LoadFromAssemblyPath(String) LoadFromAssemblyPath(String) LoadFromAssemblyPath(String) LoadFromAssemblyPath(String)

Carica il contenuto di un file di assembly nel percorso specificato.Loads the contents of an assembly file on the specified path.

LoadFromNativeImagePath(String, String) LoadFromNativeImagePath(String, String) LoadFromNativeImagePath(String, String) LoadFromNativeImagePath(String, String)

Carica il contenuto dell'immagine nativa di un file di assembly gestito nel percorso specificato.Loads the contents of the native image of a managed assembly file on the specified path.

LoadFromStream(Stream) LoadFromStream(Stream) LoadFromStream(Stream) LoadFromStream(Stream)

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) contenente un assembly gestito.Loads the assembly with a common object file format (COFF)-based image containing a managed assembly.

LoadFromStream(Stream, Stream) LoadFromStream(Stream, Stream) LoadFromStream(Stream, Stream) LoadFromStream(Stream, Stream)

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly gestito e include facoltativamente i simboli per l'assembly.Loads the assembly with a common object file format (COFF)-based image containing a managed assembly, optionally including symbols for the assembly.

LoadUnmanagedDll(String) LoadUnmanagedDll(String) LoadUnmanagedDll(String) LoadUnmanagedDll(String)

Consente alla classe derivata di caricare una libreria non gestita in base al nome.Allows derived class to load an unmanaged library by name.

LoadUnmanagedDllFromPath(String) LoadUnmanagedDllFromPath(String) LoadUnmanagedDllFromPath(String) LoadUnmanagedDllFromPath(String)

Carica una libreria non gestita dal percorso specificato.Loads an unmanaged library from the specified path.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
SetProfileOptimizationRoot(String) SetProfileOptimizationRoot(String) SetProfileOptimizationRoot(String) SetProfileOptimizationRoot(String)

Imposta il percorso radice in cui vengono archiviati i profili di ottimizzazione per questo contesto di caricamento.Sets the root path where the optimization profiles for this load context are stored.

StartProfileOptimization(String) StartProfileOptimization(String) StartProfileOptimization(String) StartProfileOptimization(String)

Avvia l'ottimizzazione del profilo per il profilo specificato.Starts the profile optimization for the specified profile.

ToString() ToString() ToString() ToString()

Restituisce la rappresentazione stringa di questo contesto di caricamento.Returns the string representation of this load context.

Unload() Unload() Unload() Unload()

Avvia uno scaricamento di questo AssemblyLoadContext.Initiates an unload of this AssemblyLoadContext.

Eventi

Resolving Resolving Resolving Resolving

Si verifica se la risoluzione di un assembly ha esito negativo quando si tenta di caricare in questo contesto di caricamento dell'assembly.Occurs when the resolution of an assembly fails when attempting to load into this assembly load context.

ResolvingUnmanagedDll ResolvingUnmanagedDll ResolvingUnmanagedDll ResolvingUnmanagedDll

Si verifica quando la risoluzione di una libreria nativa ha esito negativo.Occurs when the resolution of a native library fails.

Unloading Unloading Unloading Unloading

Si verifica quando AssemblyLoadContext viene scaricato.Occurs when the AssemblyLoadContext is unloaded.

Si applica a

Vedi anche