Entri registri untuk Add-in VSTO
Anda harus membuat sekumpulan entri registri tertentu saat menyebarkan Add-in VSTO yang dibuat dengan menggunakan Visual Studio. Entri registri ini menyediakan informasi yang memungkinkan Microsoft aplikasi Office lication untuk menemukan dan memuat Add-in VSTO.
Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek Add-in VSTO. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.
Catatan
Tertarik untuk mengembangkan solusi yang memperluas pengalaman Office di beberapa platform? Lihat model Add-in Office baru. Add-in Office memiliki jejak kecil dibandingkan dengan Add-in dan solusi VSTO, dan Anda dapat membuatnya dengan menggunakan hampir semua teknologi pemrograman web, seperti HTML5, JavaScript, CSS3, dan XML.
Saat Anda membuat proyek, Visual Studio membuat entri registri ini di komputer pengembangan. Ini membantu Anda dengan mudah menjalankan dan men-debug Add-in VSTO. Menggunakan ClickOnce untuk menyebarkan Add-in VSTO Anda, entri registri secara otomatis dibuat di komputer pengguna akhir.
Untuk informasi selengkapnya tentang cara menyebarkan Solusi VSTO Menggunakan Penginstal Windows, lihat Menyebarkan Solusi VSTO Menggunakan Penginstal Windows.
Untuk informasi selengkapnya tentang bagaimana entri registri digunakan selama proses pemuatan untuk Add-in VSTO, lihat Arsitektur Add-in VSTO.
Catatan
Dalam topik ini, ID add-in teks mewakili ID unik untuk Add-in VSTO Anda. Secara default, ID adalah nama rakitan Add-in VSTO Anda.
Mendaftarkan Add-in VSTO untuk pengguna saat ini vs. semua pengguna
Ketika Add-in VSTO diinstal, add-in dapat didaftarkan dengan dua cara:
Hanya untuk pengguna saat ini (Add-in VSTO hanya tersedia untuk pengguna yang masuk ke komputer ketika Add-in diinstal). Dalam hal ini, entri registri dibuat di bawah HKEY_CURRENT_USER.
Untuk semua pengguna (yaitu, setiap pengguna yang masuk ke komputer dapat menggunakan Add-in VSTO). Dalam hal ini, entri registri dibuat di bawah HKEY_LOCAL_MACHINE.
Semua Add-in VSTO yang Anda buat dengan menggunakan Visual Studio dapat didaftarkan untuk pengguna saat ini. Namun, Add-in VSTO dapat didaftarkan untuk semua pengguna hanya dalam skenario tertentu. Skenario ini bergantung pada versi Microsoft Office di komputer dan bagaimana Add-in VSTO disebarkan.
Jenis penyebaran
Jika Anda menggunakan ClickOnce untuk menyebarkan Add-in VSTO, Add-in VSTO hanya dapat didaftarkan untuk pengguna saat ini. Ini karena ClickOnce hanya mendukung pembuatan kunci di bawah HKEY_CURRENT_USER. Jika Anda ingin mendaftarkan Add-in VSTO ke semua pengguna di komputer, Anda harus menggunakan Penginstal Windows untuk menyebarkan Add-in VSTO. Untuk informasi selengkapnya tentang jenis penyebaran ini, lihat Menyebarkan solusi Office dengan menggunakan ClickOnce dan Menyebarkan solusi Office dengan menggunakan Penginstal Windows.
Entri registri
Entri registri Add-in VSTO yang diperlukan terletak di bawah kunci registri berikut di mana Root HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE tergantung apakah penginstalan adalah untuk pengguna saat ini atau semua pengguna.
| Aplikasi Office | Jalur Konfigurasi |
|---|---|
| Visio | ID Root\Software\Microsoft\Visio\Addins\add-in |
| Semua Lainnya | ROOT\Software\Microsoft\Office\aplikasi Office lication name\Addins\add-in ID |
Catatan
Jika alat penginstal menargetkan semua pengguna pada Windows 64-bit, disarankan agar menyertakan dua entri registri, satu di bawah HKEY_LOCAL_MACHINE\Software\Microsoft dan satu di bawah HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft hive. Ini karena pengguna dapat menggunakan Office versi 32-bit atau 64-bit di komputer.
Jika Penginstal menargetkan pengguna saat ini, penginstal tidak perlu menginstal ke WOW6432Node karena jalur HKEY_CURRENT_USER\Software dibagikan.
Untuk informasi selengkapnya, lihat Data Aplikasi 32-bit dan 64-bit di Registri.
Tabel berikut mencantumkan entri di bawah kunci registri ini.
| Entri | Tipe | Nilai |
|---|---|---|
| Keterangan | REG_SZ | Harus diisi. Deskripsi singkat tentang Add-in VSTO. Deskripsi ini ditampilkan saat pengguna memilih Add-in VSTO di panel Add-In dari kotak dialog Opsi di Microsoft aplikasi Office lication. |
| FriendlyName | REG_SZ | Harus diisi. Nama deskriptif Add-in VSTO yang ditampilkan dalam kotak dialog Add-In COM di Microsoft aplikasi Office lication. Nilai defaultnya adalah ID Add-in VSTO. |
| LoadBehavior | REG_DWORD | Harus diisi. Nilai yang menentukan kapan aplikasi mencoba memuat Add-in VSTO dan status Add-in VSTO saat ini (dimuat atau dibongkar). Secara default, entri ini diatur ke 3, yang menentukan bahwa Add-in VSTO dimuat saat startup. Untuk informasi selengkapnya, lihat Nilai LoadBehavior. Catatan: Jika pengguna menonaktifkan Add-in VSTO, tindakan tersebut memodifikasi nilai LoadBehavior di sarang registri HKEY_CURRENT_USER . Untuk setiap pengguna, nilai nilai LoadBehavior di sarang HKEY_CURRENT_USER mengambil alih LoadBehavior default yang ditentukan dalam sarang HKEY_LOCAL_MACHINE. |
| Manifes | REG_SZ | Harus diisi. Jalur lengkap manifes penyebaran untuk Add-in VSTO. Jalur dapat menjadi lokasi di komputer lokal, berbagi jaringan (UNC), atau server Web (HTTP). Jika Anda menggunakan Penginstal Windows untuk menyebarkan solusi, Anda harus menambahkan awalan file:/// ke jalur manifes . Anda juga harus menambahkan string |vstolocal (yaitu, karakter | pipa diikuti dengan vstolocal) ke akhir jalur ini. Ini memastikan bahwa solusi Anda dimuat dari folder penginstalan, bukan cache ClickOnce. Untuk informasi selengkapnya, lihat Menyebarkan solusi Office dengan menggunakan Penginstal Windows. Catatan: Saat Anda membuat Add-in VSTO di komputer pengembangan, Visual Studio secara otomatis menambahkan string |vstolocal ke entri registri ini. |
Entri registri untuk wilayah formulir Outlook
Jika Anda membuat wilayah formulir kustom di Add-in VSTO untuk Outlook, entri registri tambahan digunakan untuk mendaftarkan wilayah formulir dengan Outlook. Entri ini dibuat di bawah kunci registri yang berbeda untuk setiap kelas pesan yang didukung wilayah formulir. Kunci registri ini berada di lokasi berikut, di mana Root HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE.
Root\Software\Microsoft\Office\Outlook\FormRegions\message class
Seperti entri registri lain yang dibagikan oleh semua Add-in VSTO, Visual Studio membuat entri registri wilayah formulir di komputer pengembangan saat Anda membangun proyek Anda. Menggunakan ClickOnce untuk menyebarkan Add-in VSTO Anda, entri registri secara otomatis dibuat di komputer pengguna akhir. Saat Anda menggunakan Penginstal Windows untuk menyebarkan Add-in VSTO, Anda harus mengonfigurasi proyek InstallShield Limited Edition untuk membuat entri registri di komputer pengguna akhir.
Untuk informasi selengkapnya tentang entri registri wilayah formulir, lihat Menentukan lokasi wilayah formulir dalam formulir kustom. Untuk informasi selengkapnya tentang wilayah formulir Outlook, lihat Membuat wilayah formulir Outlook.
Nilai LoadBehavior
Entri LoadBehavior di bawah kunci ID Root\Software\Microsoft\Office\application name\Addins\add-in berisi kombinasi bitwise nilai yang menentukan perilaku run time add-in VSTO. Bit urutan terendah (nilai 0 dan 1) menunjukkan apakah Add-in VSTO saat ini dibongkar atau dimuat. Bit lain menunjukkan kapan aplikasi mencoba memuat Add-in VSTO.
Biasanya, entri LoadBehavior dimaksudkan untuk diatur ke 0, 3, atau 16 (dalam desimal) ketika Add-in VSTO diinstal pada komputer pengguna akhir. Secara default, Visual Studio mengatur entri LoadBehavior add-in VSTO Anda ke 3 saat Anda membuat atau menerbitkannya.
Tabel berikut mencantumkan semua nilai yang mungkin dari entri LoadBehavior . Beberapa deskripsi dalam tabel ini mengacu pada pemuatan Add-in VSTO secara manual atau terprogram. Untuk memuat Add-in VSTO secara manual, pilih kotak centang di samping Add-in VSTO dalam kotak dialog Add-In COM di aplikasi. Untuk memuat Add-in VSTO secara terprogram, atur Connect properti COMAddIn objek yang mewakili Add-in VSTO ke true.
| Nilai (dalam desimal) | Status Add-in VSTO | Perilaku beban Add-in VSTO | Deskripsi |
|---|---|---|---|
| 0 | Dibongkar | Jangan muat secara otomatis | Aplikasi tidak pernah mencoba memuat Add-in VSTO secara otomatis. Pengguna dapat mencoba memuat Add-in VSTO secara manual, atau Add-in VSTO dapat dimuat secara terprogram. Jika Add-in VSTO berhasil dimuat, nilai LoadBehavior tetap 0, tetapi status Add-in VSTO dalam kotak dialog Add-in COM diperbarui untuk menunjukkan bahwa Add-in VSTO dimuat. |
| 1 | Dimuat | Jangan muat secara otomatis | Aplikasi tidak pernah mencoba memuat Add-in VSTO secara otomatis. Pengguna dapat mencoba memuat Add-in VSTO secara manual, atau Add-in VSTO dapat dimuat secara terprogram. Meskipun kotak dialog Add-in COM menunjukkan bahwa Add-in VSTO dimuat setelah aplikasi dimulai, Add-in VSTO tidak dimuat sampai dimuat secara manual atau terprogram. Jika aplikasi berhasil memuat Add-in VSTO, nilai LoadBehavior berubah menjadi 0, dan tetap pada 0 setelah aplikasi ditutup. |
| 2 | Dibongkar | Muat saat startup | Aplikasi tidak mencoba memuat Add-in VSTO secara otomatis. Pengguna dapat mencoba memuat Add-in VSTO secara manual, atau Add-in VSTO dapat dimuat secara terprogram. Jika aplikasi berhasil memuat Add-in VSTO, nilai LoadBehavior berubah menjadi 3, dan tetap pada 3 setelah aplikasi ditutup. |
| 3 | Dimuat | Muat saat startup | Aplikasi mencoba memuat Add-in VSTO saat aplikasi dimulai. Ini adalah nilai default saat Anda membuat atau menerbitkan Add-in VSTO di Visual Studio. Jika aplikasi berhasil memuat Add-in VSTO, nilai LoadBehavior tetap 3. Jika terjadi kesalahan saat memuat Add-in VSTO, nilai LoadBehavior berubah menjadi 2, dan tetap berada di 2 setelah aplikasi ditutup. |
| 8 | Dibongkar | Muat sesuai permintaan | Aplikasi tidak mencoba memuat Add-in VSTO secara otomatis. Pengguna dapat mencoba memuat Add-in VSTO secara manual, atau Add-in VSTO dapat dimuat secara terprogram. Jika aplikasi berhasil memuat Add-in VSTO, nilai LoadBehavior berubah menjadi 9. |
| 9 | Dimuat | Muat sesuai permintaan | Add-in VSTO hanya akan dimuat ketika aplikasi memerlukannya. Seperti saat pengguna memilih elemen UI yang menggunakan fungsionalitas di Add-in VSTO (misalnya, tombol kustom di Pita). Jika aplikasi berhasil memuat Add-in VSTO, nilai LoadBehavior tetap 9, tetapi status Add-in VSTO dalam kotak dialog Add-in COM diperbarui untuk menunjukkan bahwa Add-in VSTO saat ini dimuat. Jika terjadi kesalahan saat memuat Add-in VSTO, nilai LoadBehavior berubah menjadi 8. |
| 16 | Dimuat | Muat pertama kali, lalu muat sesuai permintaan | Atur nilai ini jika Anda ingin Add-in VSTO Anda dimuat sesuai permintaan. Aplikasi memuat Add-in VSTO saat pengguna menjalankan aplikasi untuk pertama kalinya. Saat berikutnya pengguna menjalankan aplikasi, aplikasi memuat elemen UI apa pun yang ditentukan oleh Add-in VSTO. Namun, Add-in VSTO tidak dimuat sampai pengguna memilih elemen UI yang terkait dengan Add-in VSTO. Ketika aplikasi berhasil memuat Add-in VSTO untuk pertama kalinya, nilai LoadBehavior tetap 16 saat Add-in VSTO dimuat. Setelah aplikasi ditutup, nilai LoadBehavior berubah menjadi 9. |