Men-debug proyek Office
Anda dapat men-debug proyek Office dengan menggunakan alat Microsoft Visual Studio yang sama dengan yang Anda gunakan untuk proyek Visual Studio lainnya. Fitur debugger Visual Studio, seperti kemampuan untuk menyisipkan titik henti dan melihat variabel di jendela Lokal , juga tersedia saat Anda men-debug proyek Office. Untuk informasi selengkapnya tentang alat penelusuran kesalahan Visual Studio, lihat Debug di Visual Studio.
Tip
Untuk menyederhanakan penelusuran kesalahan, tutup instans terbuka aplikasi Office likasi sebelum Anda membuat dan men-debugnya.
Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO. 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.
Memulai dan menghentikan debugger
Anda bisa mulai men-debug proyek Office seperti mulai men-debug proyek Visual Studio lainnya; misalnya, Anda dapat menekan tombol F5 . Saat Anda mulai men-debug proyek Add-in VSTO, proses baru untuk aplikasi Office likasi yang ditargetkan dimulai dan Add-in VSTO dimuat.
Saat Anda mulai men-debug proyek tingkat dokumen, dokumen atau buku kerja terbuka dalam proses Word atau Excel baru.
Ketika Anda menghentikan debugger, debugger mengakhiri proses aplikasi secara mendadak, atau melepaskan jika Anda memiliki debugger yang diatur untuk melepaskannya. Semua dokumen lain yang dibuka dalam proses aplikasi Office likasi yang dihentikan juga ditutup tanpa peringatan, dan perubahan yang belum disimpan hilang. Ini mungkin termasuk semua dokumen atau buku kerja yang dibuka saat debugger sedang berjalan.
Biasanya, lebih baik melepaskan dari proses sebelum menghentikan debugger, sehingga Anda dapat keluar dari aplikasi Office likasi dengan cara normal. Anda juga bisa melepaskan dari proses terlebih dahulu jika Anda masih ingin bekerja dengan dokumen atau lembar kerja yang terbuka setelah menghentikan debugger.
Jika Anda men-debug kustomisasi tingkat dokumen untuk Word, berulang kali menghentikan debugger dan menyebabkan Word ditutup tiba-tiba dapat menyebabkan templat Normal rusak. Jika ini terjadi, Anda bisa menghapus templat Normal yang rusak dan templat tersebut akan dibuat ulang secara otomatis saat anda membuka Word berikutnya. Namun, makro apa pun yang disimpan dalam templat Normal tidak dibuat ulang.
Men-debug Add-in Office 2013 VSTO dengan menggunakan Office 2013 atau Office 2016
Jika Anda menggunakan Visual Studio 2015, dan Anda memiliki kedua versi Office yang terinstal secara berdampingan, Visual Studio memulai Office 2016. Jika Anda menggunakan Visual Studio 2013, Visual Studio memulai Office 2013.
Jika Anda ingin men-debug Add-in VSTO Anda dengan menggunakan versi Office yang berbeda (2013 atau 2016), buka Perancang Proyek, dan di tab Debug , pilih tombol opsi Mulai program eksternal. Kemudian, telusuri ke lokasi executable aplikasi Office lication yang sesuai.
Perilaku F10 dan F11
Saat Anda mulai men-debug proyek Office, F10 dan F11 tidak memiliki perilaku yang sama seperti saat Anda mulai men-debug proyek Visual Basic atau C# lainnya. Dalam proyek Visual Basic atau C#, debugger berhenti pada fungsi utama; di proyek Office, Visual Studio tidak memiliki kontrol atas fungsi utama aplikasi Office likasi. Namun, selama penelusuran kesalahan, F10 dan F11 memang memiliki fungsi yang sama seperti dalam proyek Visual Basic dan C#.
Tampilkan pengecualian
Karena cara kode terkelola berinteraksi dengan kode yang tidak dikelola, Visual Studio tidak menampilkan kesalahan yang dilemparkan oleh Microsoft aplikasi Office lications. Misalnya, jika Add-in VSTO yang dibuat dengan menggunakan alat pengembangan Office di Visual Studio memberikan pengecualian, microsoft aplikasi Office lication berlanjut tanpa menampilkan kesalahan. Untuk melihat kesalahan ini, atur debugger untuk memutuskan pengecualian runtime bahasa umum. Untuk informasi selengkapnya, lihat Mengelola pengecualian dengan debugger.
Jika Anda mengatur debugger untuk memutuskan pengecualian runtime bahasa umum, semua pengecualian sekarang akan masuk ke debugger, termasuk yang telah Anda tangani dan beberapa pengecualian kesempatan pertama dari runtime itu sendiri, yang mungkin tidak relevan dengan proyek Anda. Kesalahan yang mengacu pada msosec tidak ditemukan muncul di setiap proyek, tetapi aman untuk diabaikan. Pengecualian msosec ini tidak akan memengaruhi solusi Anda.
Anda juga dapat menggunakan Coba... Tangkap pernyataan di sekitar metode Anda untuk menangkap pengecualian.
Secara default, Visual Studio juga tidak menampilkan kesalahan penelusuran kesalahan Just-In-Time untuk proyek Office; namun, Anda dapat mengaktifkan fitur ini sehingga Anda dapat melihat kesalahan yang dimunculkan. Untuk informasi selengkapnya, lihat Penelusuran kesalahan Just-In-Time di Visual Studio.
Argumen baris perintah
Jika Tindakan Mulai pada halaman properti Debug diatur ke Mulai Proyek, Visual Studio tidak menggunakan argumen baris perintah saat men-debug proyek, bahkan jika Anda telah menentukan argumen baris perintah sebagai opsi mulai. Jika Anda ingin menggunakan argumen baris perintah saat memulai penelusuran kesalahan, Anda harus memilih Tindakan Mulai selain Mulai Proyek.
Kontrol sumber
Properti debug tidak dibagikan di antara beberapa pengguna di bawah kontrol sumber. Proyek Visual Basic dan C# menyimpan properti penelusuran kesalahan dalam file khusus pengguna (ProjectName.vbproj.user atau ProjectName.csproj.user), dan file ini tidak berada di bawah kontrol sumber. Jika lebih dari satu orang melakukan penelusuran kesalahan, setiap orang harus memasukkan properti debug secara manual.
Men-debug himpunan data yang di-cache dalam proyek tingkat dokumen
Setiap kali Anda membuat proyek, himpunan data dikosongkan dan dibuat ulang. Jika Anda ingin men-debug himpunan data yang di-cache, Anda harus membuka dokumen di luar Visual Studio lalu melampirkan debugger.
Men-debug proyek dokumen Word berdasarkan format Dokumen Word 97-2003 (*.doc)
Untuk men-debug proyek Dokumen Word berdasarkan format Dokumen Word 97-2003 (/.doc*), Anda harus menambahkan folder proyek ke daftar folder tepercaya. Untuk informasi selengkapnya tentang cara melakukannya, lihat Memberikan kepercayaan ke dokumen.
Add-in yang dinonaktifkan debug
Microsoft aplikasi Office lications dapat menonaktifkan Add-in VSTO yang berperilaku tidak terduga. Microsoft aplikasi Office lication menonaktifkan Add-in VSTO untuk mencegah kode bermasalah dimuat setiap kali aplikasi dimulai. Namun, juga mudah untuk menyebabkan perilaku tak terduga selama debugging khas. Untuk informasi tentang cara mengaktifkan kembali Add-in VSTO, lihat Cara: Mengaktifkan kembali Add-in VSTO yang telah dinonaktifkan.
Ada dua jenis penonaktifan yang digunakan Microsoft aplikasi Office lications untuk Add-in VSTO: penonaktifan keras dan penonaktifan sementara.
Pennonaktifkanan keras
Penonaktifan keras dapat terjadi ketika Add-in VSTO menyebabkan aplikasi menutup secara tak terduga. Ini mungkin juga terjadi di komputer pengembangan Anda jika Anda menghentikan debugger saat Startup penanganan aktivitas di Add-in VSTO Anda sedang dijalankan. Ketika Add-in VSTO dinonaktifkan dengan keras, add-in tersebut muncul di daftar Item Yang Dinonaktifkan di aplikasi.
Jika hard aplikasi Office lication menonaktifkan Add-in VSTO yang dibuat dengan menggunakan alat pengembangan Office di Visual Studio, aplikasi hanya menonaktifkan Add-in VSTO yang menyebabkan kegagalan. Add-in VSTO lainnya yang dibuat dengan menggunakan alat pengembangan Office di Visual Studio untuk aplikasi Office likasi tersebut akan terus dimuat.
Pennonaktifkanan sementara
Penonaktifan sementara dapat terjadi ketika Add-in VSTO menghasilkan kesalahan yang tidak menyebabkan aplikasi menutup secara tiba-tiba. Misalnya, aplikasi mungkin menonaktifkan add-in VSTO jika melemparkan pengecualian yang tidak tertangani saat Startup penanganan aktivitas sedang dijalankan. Ketika Add-in VSTO dinonaktifkan sementara, itu muncul dalam daftar Add-in Aplikasi Tidak Aktif dalam aplikasi, dan aplikasi mengubah nilai entri registri LoadBehavior untuk Add-in VSTO untuk menunjukkan bahwa itu dibongkar. Untuk informasi selengkapnya tentang entri registri LoadBehavior , lihat Entri registri untuk Add-in VSTO.
Memecahkan masalah kesalahan penginstalan dengan menggunakan Pemantau Peristiwa
Runtime Visual Studio Tools for Office menulis pesan ke Pemantau Peristiwa di Windows untuk semua pengecualian yang dilemparkan saat Anda menginstal atau menghapus instalan solusi Office. Anda dapat menggunakan pesan ini untuk mengatasi masalah penginstalan dan penyebaran.
Memecahkan masalah kesalahan startup dengan menggunakan file log dan pesan kesalahan
Runtime Visual Studio Tools for Office dapat menulis semua kesalahan yang terjadi selama pengaktifan ke file log atau menampilkan setiap kesalahan dalam kotak pesan. Secara default, opsi ini dinonaktifkan. Anda dapat mengaktifkan opsi dengan membuat variabel lingkungan.
Untuk menampilkan setiap kesalahan dalam kotak pesan, buat variabel lingkungan bernama VSTO_SUPPRESSDISPLAYALERTS dan atur ke 0 (nol). Anda dapat menekan pesan dengan menghapus variabel lingkungan atau mengaturnya ke 1 (satu).
Untuk menulis kesalahan ke file log, buat variabel lingkungan bernama VSTO_LOGALERTS dan atur ke 1 (satu). Runtime Visual Studio Tools for Office membuat file log di folder yang berisi manifes penyebaran untuk Add-in VSTO, atau di folder yang berisi dokumen atau buku kerja yang terkait dengan kustomisasi. Jika gagal, runtime Visual Studio Tools for Office membuat file log di folder %TEMP% lokal. Untuk Add-in VSTO tingkat aplikasi, nama defaultnya adalah add-in name.vsto.log. Untuk proyek tingkat dokumen, nama file log adalah nama dokumen.extension.log, seperti ExcelWorkbook1.xlsx.log. Untuk menghentikan kesalahan pengelogan, hapus variabel lingkungan atau atur ke 0 (nol).