Hanterad assembly-inläsningsalgoritm

Hanterade enheter hittas och laddas med en algoritm som har olika faser.

Alla hanterade sammansättningar utom satellitsammansättningar och WinRT sammansättningar använder samma algoritm.

När läses hanterade sammansättningar in?

Den vanligaste mekanismen för att utlösa en hanterad sammansättningsbelastning är en referens för statisk sammansättning. Dessa referenser infogas av kompilatorn när koden använder en typ som definierats i en annan sammansättning. Dessa sammansättningar laddas in (load-by-name) efter behov av körmiljön. Den exakta tidpunkten för när de statiska sammansättningsreferenserna läses in är ospecificerad. Det kan variera mellan körningsversioner och påverkas av optimeringar som inlining.

Direkt användning av följande API:er utlöser också belastningar:

API (gränssnitt för programmering av applikationer)	Beskrivning	Active AssemblyLoadContext
AssemblyLoadContext.LoadFromAssemblyName	Load-by-name	Den här instansen.
AssemblyLoadContext.LoadFromAssemblyPath AssemblyLoadContext.LoadFromNativeImagePath	Läs in från sökvägen.	Den här instansen.
AssemblyLoadContext.LoadFromStream	Läs in från objekt.	Den här instansen.
Assembly.LoadFile	Läs in från sökväg i en ny AssemblyLoadContext-instans	Den nya AssemblyLoadContext instansen.
Assembly.LoadFrom	Läs in från sökvägen i AssemblyLoadContext.Default instansen. Lägger till en AppDomain.AssemblyResolve hanterare. Hanteraren läser in sammansättningens beroenden från dess katalog.	Instansen AssemblyLoadContext.Default .
Assembly.Load(AssemblyName) Assembly.Load(String) Assembly.LoadWithPartialName	Load-by-name.	Härledd från den som ringer. Föredrar AssemblyLoadContext metoder.
Assembly.Load(Byte[]) Assembly.Load(Byte[], Byte[])	Läs in från objekt i en ny AssemblyLoadContext instans.	Den nya AssemblyLoadContext instansen.
Type.GetType(String) Type.GetType(String, Boolean) Type.GetType(String, Boolean, Boolean)	Load-by-name.	Härledd från den som ringer. Föredrar Type.GetType metoder med ett assemblyResolver argument.
Assembly.GetType	Om typen name beskriver en sammansättningskvalificerad allmän typ utlöser du en Load-by-name.	Härledd från den som ringer. Föredra Type.GetType när du använder sammansättningskvalificerade typnamn.
Activator.CreateInstance(String, String) Activator.CreateInstance(String, String, Object[]) Activator.CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Load-by-name.	Härledd från den som ringer. Föredrar Activator.CreateInstance metoder som tar ett Type argument.

Viktigt!

Till skillnad från .NET Framework, behandlas parametern assemblyFile av Assembly.LoadFrom i .NET som en filsökväg och inte som en URI. I .NET Framework kan du skicka en fil-URI (till exempel file:///C:/path/to/assembly.dll)– till exempel en som har konstruerats från Assembly.CodeBase– och sammansättningen läses in korrekt. I .NET assemblyFile skickas värdet till Path.GetFullPath, som inte hanterar URI:er korrekt, så belastningen misslyckas. Om du redan har en fil-URI-sträng skapar du först en Uri instans och använder dess LocalPath egenskap för att hämta filsökvägen innan du anropar Assembly.LoadFrom. Om du vill hämta filsökvägen för en redan inläst sammansättning använder du Assembly.Location i stället för CodeBase.

Algoritm

Följande algoritm beskriver hur körtiden laddar in en hanterad assembly.

1. Fastställ activeAssemblyLoadContext.

   • För en statisk referens till activeAssemblyLoadContext är den instans som laddade den refererande sammansättningen.
   • Önskade API:er gör det activeAssemblyLoadContext explicit.
   • Andra API:er härleder activeAssemblyLoadContext. För dessa API:er används egenskapen AssemblyLoadContext.CurrentContextualReflectionContext . Om dess värde är nullanvänds den härledda instansen AssemblyLoadContext .
   • Se tabellen i avsnittet När läses hanterade sammansättningar in?

2. För metoderna Load-by-nameactive laddar in assemblyn i följande prioritetsordning:

   • Kontrollera dess cache-by-name.
   • Kalla på funktionen AssemblyLoadContext.Load.
   • Kontrollera instansens AssemblyLoadContext.Default cacheminne och kör standardlogik för avsökning av hanterad sammansättning . Om en sammansättning nyligen har lästs in läggs en referens till i instansens AssemblyLoadContext.Defaultcache-by-name.
   • Utlysa händelsen AssemblyLoadContext.Resolving för den aktiva AssemblyLoadContext.
   • Utlös händelsen AppDomain.AssemblyResolve.

3. För de andra typerna av laster läser activeAssemblyLoadContext in sammansättningen i följande prioritetsordning:

   • Kontrollera dess cache-by-name.
   • Om activeAssemblyLoadContext är AssemblyLoadContext.Default, kör standardlogiken för avsökning av hanterade sammansättningar.
   • Läs in från den angivna sökvägen eller det råa sammansättningsobjektet. Om en sammansättning nyligen har lästs in läggs en referens i instansens activeAssemblyLoadContextcache-by-name.

4. I båda fallen, om en sammansättning nyligen har lästs in, AppDomain.AssemblyLoad utlöses händelsen.