Tentang Rakitan Privat

Rakitan privat adalah rakitan yang disebarkan dengan aplikasi dan tersedia untuk penggunaan eksklusif aplikasi tersebut. Artinya, aplikasi lain tidak berbagi assembly privat. Rakitan privat adalah salah satu metode yang dapat digunakan untuk membuat aplikasi yang terisolasi. Untuk informasi selengkapnya, lihat Tentang Aplikasi Terisolasi dan Rakitan Berdampingan.

Rakitan privat harus dirancang untuk bekerja berdampingan dengan versi rakitan lain pada sistem. Untuk informasi selengkapnya, lihat Panduan untuk Membuat Rakitan Berdampingan.

Rakitan privat harus disertai dengan manifes perakitan. Perhatikan bahwa pembatasan nama berlaku saat mengemas DLL sebagai rakitan privat untuk mengakomodasi cara Windows mencari rakitan privat. Saat mencari rakitan privat, metode yang disarankan adalah menyertakan manifes perakitan di DLL sebagai sumber daya. Dalam hal ini, ID sumber daya harus sama dengan 1 dan nama rakitan privat mungkin sama dengan nama DLL. Misalnya, jika nama DLL MICROSOFT.WINDOWS.MYSAMPLE.DLL, nilai atribut nama yang digunakan dalam elemen assemblyIdentity dari manifes mungkin juga Microsoft.Windows.mysample. Metode alternatif untuk mencari rakitan privat adalah menyediakan manifes perakitan dalam file terpisah. Dalam hal ini, nama rakitan dan manifesnya harus berbeda dari nama DLL. Misalnya, Microsoft.Windows.mysampleAsm, Microsoft.Windows.mysampleAsm.manifest, dan Microsoft.Windows.mysample.dll. Untuk informasi selengkapnya tentang cara pencarian berdampingan untuk rakitan privat, lihat Urutan Pencarian Perakitan.

Rakitan privat diinstal dalam folder struktur direktori aplikasi. Biasanya, ini adalah folder yang berisi file yang dapat dieksekusi aplikasi. Rakitan privat dapat disebarkan di folder yang sama dengan aplikasi, dalam folder dengan nama yang sama dengan rakitan, atau dalam subfolder spesifik bahasa dengan nama yang sama dengan rakitan. Misalnya, gunakan salah satu struktur direktori berikut untuk menyebarkan rakitan privat, Microsoft.tools.pop, tanpa bahasa yang ditentukan.

Struktur direktori	Deskripsi
APPDIR\MICROSOFT.TOOLS.POP.DLL	Manifes disebarkan sebagai sumber daya di DLL.
Appdir\Microsoft.Tools.Pop.MANIFEST	Manifes disebarkan sebagai file terpisah.
APPDIR\MICROSOFT.TOOLS.POP\MICROSOFT.TOOLS.POP.DLL	Manifes disebarkan sebagai sumber daya di DLL, yang berada dalam subfolder yang memiliki nama assembly.
Appdir\Microsoft.Tools.Pop\Microsoft.Tools.Pop.MANIFEST	Manifes disebarkan sebagai file terpisah dalam subfolder yang memiliki nama assembly.

 

Penting

Untuk versi sistem operasi Windows sebelum Windows 7 dan Windows Server 2008 R2, rakitan privat asli harus disebarkan di folder yang berisi file aplikasi yang dapat dieksekusi. Penginstalan dalam folder spesifik bahasa atau di folder dengan nama yang sama dengan assembly tidak didukung untuk rakitan privat asli.

 

Gunakan salah satu struktur direktori berikut untuk menyebarkan rakitan privat, Microsoft.tools.pop, dengan bahasa tertentu. Dalam contoh berikut, bahasa yang digunakan oleh Microsoft.Tools.Pop adalah bahasa Inggris (Amerika Serikat) dan kode bahasanya adalah en-us. Anda harus mengganti kode bahasa DHTML yang benar untuk assembly Anda.

appdir\en-us\Microsoft.tools.pop.DLL
appdir\en-us\Microsoft.tools.pop.MANIFEST
appdir\en-us\Microsoft.tools.pop\Microsoft.tools.pop.DLL
appdir\en-us\Microsoft.tools.pop\Microsoft.tools.pop.MANIFEST

Rakitan privat dapat diinstal dengan metode penginstalan apa pun yang dapat menyalin file assembly ke dalam folder ini, seperti perintah xcopy . Untuk informasi selengkapnya tentang cara menginstal rakitan privat menggunakan Penginstal Windows, lihat Penginstalan Rakitan Win32.

Rakitan privat juga dapat diinstal pada sistem operasi yang lebih lama dari Windows XP. Dalam hal ini, assembly harus didaftarkan dan pada sistem operasi ini manifes tidak digunakan. Salinan rakitan privat diinstal ke dalam folder privat untuk penggunaan eksklusif aplikasi. Versi lain dari assembly dapat didaftarkan secara global pada sistem dan tersedia untuk aplikasi apa pun yang mengikatnya. Versi global assembly mungkin versi yang diinstal dengan aplikasi atau versi yang lebih lama. Untuk informasi selengkapnya, lihat Pengalihan DLL/COM di Windows. Rakitan juga dapat diinstal sebagai rakitan bersama untuk digunakan oleh beberapa aplikasi. Untuk informasi selengkapnya, lihat Rakitan Bersama.

Perhatikan bahwa langkah-langkah untuk membuat rakitan privat identik dengan langkah-langkah untuk membuat rakitan bersama dengan dua pengecualian:

• Rakitan privat tidak perlu ditandatangani, dan publickeyToken tidak diperlukan dalam elemen assemblyIdentity dari manifes assembly.
• Rakitan privat dapat diinstal ke folder aplikasi menggunakan teknologi penginstalan apa pun. Rakitan privat tidak diperlukan untuk diinstal menggunakan Pemasang Windows.