Kelas System.Runtime.Loader.AssemblyLoadContext (kelas untuk memuat konteks perakitan)

Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.

AssemblyLoadContext mewakili konteks beban. Secara konseptual, konteks beban membuat cakupan untuk memuat, menyelesaikan, dan berpotensi membongkar sekumpulan rakitan.

Yang AssemblyLoadContext ada terutama untuk menyediakan isolasi pemuatan perakitan. Ini memungkinkan beberapa versi rakitan yang sama dimuat dalam satu proses. Ini menggantikan mekanisme isolasi yang disediakan oleh beberapa AppDomain instans dalam .NET Framework.

Nota

• AssemblyLoadContext tidak menyediakan fitur keamanan apa pun. Semua kode memiliki izin penuh terhadap proses.
• Hanya di .NET Core 2.0 - 2.2, AssemblyLoadContext adalah kelas abstrak. Untuk membuat kelas konkret dalam versi ini, terapkan AssemblyLoadContext.Load(AssemblyName) metode .

Penggunaan dalam runtime

Runtime mengimplementasikan dua konteks beban rakitan:

• AssemblyLoadContext.Default mewakili konteks default runtime, yang digunakan untuk rakitan utama aplikasi dan dependensi statisnya.
• Metode Assembly.LoadFile(String) ini mengisolasi assemblies yang dimuatnya dengan menginstansiasi yang paling dasar AssemblyLoadContext. Ini memiliki skema isolasi sederhana yang memuat setiap komponen dalam AssemblyLoadContext sendiri tanpa menyelesaikan dependensi.

Penggunaan aplikasi

Aplikasi dapat membuat sendiri AssemblyLoadContext untuk membuat solusi kustom untuk skenario tingkat lanjut. Penyesuaian berfokus pada menentukan mekanisme resolusi dependensi.

AssemblyLoadContext menyediakan dua titik ekstensi untuk menerapkan resolusi penyusunan terkelola.

1. Metode AssemblyLoadContext.Load(AssemblyName) memberikan kesempatan pertama bagi AssemblyLoadContext untuk menyelesaikan, memuat, dan mengembalikan assembly. Jika metode AssemblyLoadContext.Load(AssemblyName) mengembalikan null, loader mencoba memuat rakitan ke dalam AssemblyLoadContext.Default.
2. Jika AssemblyLoadContext.Default tidak dapat menyelesaikan assembly, maka AssemblyLoadContext yang asli mendapatkan kesempatan kedua untuk menyelesaikan assembly. Runtime meningkatkan Resolving peristiwa.

Selain itu, AssemblyLoadContext.LoadUnmanagedDll(String) metode virtual memungkinkan penyesuaian resolusi rakitan default yang tidak dikelola. Implementasi default mengembalikan null, yang menyebabkan pencarian runtime menggunakan kebijakan pencarian defaultnya. Kebijakan pencarian default cukup untuk sebagian besar skenario.

Tantangan teknis

• Tidak dimungkinkan untuk memuat beberapa versi runtime dalam satu proses.

  Perhatian

  Memuat beberapa salinan atau versi rakitan kerangka kerja yang berbeda dapat menyebabkan perilaku yang tidak terduga dan sulit didiagnosis.

  Petunjuk / Saran

  Gunakan batas proses dengan komunikasi jarak jauh atau antarproses untuk menyelesaikan masalah isolasi ini.

• Waktu pemuatan perakitan dapat menyulitkan pengujian dan debugging. Assembly biasanya dimuat tanpa dependensinya langsung diselesaikan. Dependensi dimuat sesuai kebutuhan:

  • Ketika kode bercabang ke dalam rakitan dependen.
  • Saat kode memuat sumber daya.
  • Ketika kode secara eksplisit memuat assembly.

• Implementasi AssemblyLoadContext.Load(AssemblyName) dapat menambahkan dependensi baru yang mungkin perlu diisolasi untuk memungkinkan versi yang berbeda ada. Implementasi yang paling alami akan menempatkan dependensi ini dalam konteks default. Desain yang cermat dapat mengisolasi dependensi baru.

• Rakitan yang sama dimuat beberapa kali ke dalam konteks yang berbeda.

  • Ini dapat menyebabkan pesan kesalahan yang membingungkan, misalnya "Tidak dapat melemparkan objek jenis 'Sample.Plugin' untuk mengetik 'Sample.Plugin'".
  • Mengorganisir melewati batas isolasi adalah tugas yang tidak sederhana. Solusi umumnya adalah menggunakan antarmuka yang ditentukan dalam rakitan yang hanya dimuat ke dalam konteks beban default.