System.Runtime.Loader.AssemblyLoadContext sınıfı

Bu makale, bu API'nin başvuru belgelerine ek açıklamalar sağlar.

bir AssemblyLoadContext yük bağlamını temsil eder. Kavramsal olarak, bir yükleme bağlamı bir derleme kümesini yüklemek, çözümlemek ve potansiyel olarak boşaltmak için bir kapsam oluşturur.

AssemblyLoadContext birincil olarak derleme yükleme yalıtımı sağlamak için vardır. Aynı derlemenin birden çok sürümünün tek bir işlem içinde yüklenmesine izin verir. .NET Framework'te birden çok AppDomain örnek tarafından sağlanan yalıtım mekanizmalarının yerini alır.

Uyarı

• AssemblyLoadContext herhangi bir güvenlik özelliği sağlamaz. Tüm kodlar işlemin tam izinlerine sahiptir.
• Yalnızca AssemblyLoadContext .NET Core 2.0 - 2.2'de soyut bir sınıftır. Bu sürümlerde somut bir sınıf oluşturmak için yöntemini uygulayın AssemblyLoadContext.Load(AssemblyName) .

Çalışma zamanında kullanım

Çalışma zamanı iki derleme yükü bağlamı uygular:

• AssemblyLoadContext.Default uygulama ana derlemesi ve statik bağımlılıkları için kullanılan çalışma zamanının varsayılan bağlamını temsil eder.
• Bu yöntem, en temel Assembly.LoadFile(String) örneği oluşturarak yüklediği AssemblyLoadContext derlemelerini yalıtıyor. Bağımlılık çözümlemesi olmadan her derlemeyi ayrı bir AssemblyLoadContext içinde yükleyen yalın bir yalıtım şemasına sahiptir.

Uygulama kullanımı

Bir uygulama, gelişmiş senaryolar için özel bir çözüm oluşturmak üzere kendi AssemblyLoadContext uygulamasını oluşturabilir. Özelleştirme, bağımlılık çözümleme mekanizmaları tanımlamaya odaklanır.

AssemblyLoadContext yönetilen derleme çözümlemesini uygulamak için iki genişleme noktası sağlar.

1. AssemblyLoadContext.Load(AssemblyName) yöntemi, derlemeyi çözümlemek, yüklemek ve döndürmek AssemblyLoadContext için ilk şansı sağlar. AssemblyLoadContext.Load(AssemblyName) yöntemi null döndürürse, yükleyici AssemblyLoadContext.Default'e derlemeyi yüklemeye çalışır.
2. derlemeyi AssemblyLoadContext.Default çözümleyemiyorsa, özgün AssemblyLoadContext derlemeyi çözümlemek için ikinci bir şans elde eder. Çalışma zamanı Resolving olayını tetikler.

Buna ek olarak, AssemblyLoadContext.LoadUnmanagedDll(String) sanal yöntem varsayılan yönetilmeyen derleme çözümlemesinin özelleştirilmesine izin verir. Varsayılan uygulama, çalışma zamanı aramasının varsayılan arama ilkesini kullanmasına neden olan değerini döndürür null. Varsayılan arama ilkesi çoğu senaryo için yeterlidir.

Teknik zorluklar

• Çalışma zamanının birden çok sürümünü tek bir işlemde yüklemek mümkün değildir.

  Dikkat

  Çerçeve derlemelerinin birden çok kopyasının veya farklı sürümlerinin yüklenmesi beklenmeyen ve tanılaması zor davranışlara yol açabilir.

  Tavsiye

  Bu yalıtım sorununu çözmek için uzaktan iletişim veya işlemler arası iletişim ile işlem sınırlarını kullanın.

• Derleme yüklemesinin zamanlaması test ve hata ayıklamayı zorlaştırabilir. Derlemeler genellikle bağımlılıkları hemen çözümlenmeden yüklenir. Bağımlılıklar gerektiğinde yüklenir:

  • Kod bağımlı bir derlemeye dallandığında.
  • Kod kaynakları yüklerken.
  • Kod açıkça derlemeleri yüklerken.

• uygulaması AssemblyLoadContext.Load(AssemblyName) , farklı sürümlerin var olması için yalıtılması gerekebilecek yeni bağımlılıklar ekleyebilir. En doğal uygulama, bu bağımlılıkları varsayılan bağlama yerleştirir. Dikkatli tasarım yeni bağımlılıkları yalıtabilir.

• Aynı derleme farklı bağlamlara birden çok kez yüklenir.

  • Bu, kafa karıştırıcı hata iletilerine yol açabilir, örneğin "'Sample.Plugin' türündeki bir nesne 'Sample.Plugin' türüne dönüştürülemiyor".
  • Yalıtım sınırları arasında koordine etmek zor bir iştir. Tipik bir çözüm, yalnızca varsayılan yük bağlamı içine yüklenen bir derlemede tanımlanan bir arabirim kullanmaktır.