Bagikan melalui

Peristiwa di proyek Office

  • Artikel

Setiap templat proyek Office secara otomatis menghasilkan beberapa penanganan aktivitas. Penanganan aktivitas untuk kustomisasi tingkat dokumen sedikit berbeda dari penanganan aktivitas untuk Add-in VSTO.

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.

Proyek tingkat dokumen

Visual Studio menyediakan kode yang dihasilkan di belakang dokumen atau lembar kerja baru atau yang sudah ada dalam kustomisasi tingkat dokumen. Kode ini menaikkan dua peristiwa berbeda: Startup dan Shutdown.

Peristiwa startup

Peristiwa Startup dimunculkan untuk setiap item host (dokumen, buku kerja, atau lembar kerja) setelah dokumen berjalan dan semua kode inisialisasi dalam rakitan telah dijalankan. Ini adalah hal terakhir yang dijalankan di konstruktor kelas tempat kode Anda berjalan. Untuk informasi selengkapnya tentang item host, lihat Gambaran umum item host dan kontrol host.

Saat Anda membuat proyek tingkat dokumen, Visual Studio membuat penanganan aktivitas untuk peristiwa Startup dalam file kode yang dihasilkan:

  • Untuk proyek Microsoft Office Word, penanganan aktivitas diberi nama ThisDocument_Startup.

  • Untuk proyek Microsoft Office Excel, penanganan aktivitas memiliki nama berikut:

    • Sheet1_Startup

    • Sheet2_Startup

    • Sheet3_Startup

    • ThisWorkbook_Startup

Peristiwa matikan

Peristiwa Matikan dinaikkan untuk setiap item host (dokumen atau lembar kerja) ketika domain aplikasi tempat kode Anda dimuat akan dibongkar. Ini adalah hal terakhir yang dipanggil di kelas saat dibongkar.

Saat Anda membuat proyek tingkat dokumen, Visual Studio membuat penanganan aktivitas untuk peristiwa Matikan dalam file kode yang dihasilkan:

  • Untuk proyek Microsoft Office Word, penanganan aktivitas diberi nama ThisDocument_Shutdown.

  • Untuk proyek Microsoft Office Excel, penanganan aktivitas memiliki nama berikut:

    • Sheet1_Shutdown

    • Sheet2_Shutdown

    • Sheet3_Shutdown

    • ThisWorkbook_Shutdown

Catatan

Jangan hapus kontrol secara terprogram selama penanganan aktivitas Matikan dokumen. Elemen UI dokumen tidak lagi tersedia saat peristiwa Matikan terjadi. Jika Anda ingin menghapus kontrol sebelum aplikasi ditutup, tambahkan kode Anda ke penanganan aktivitas lain, seperti BeforeClose atau BeforeSave.

Deklarasi metode penanganan aktivitas

Setiap deklarasi metode penanganan aktivitas memiliki argumen yang sama yang diteruskan ke dalamnya: pengirim dan e. Di Excel, argumen pengirim merujuk ke lembar, seperti Sheet1 atau Sheet2; di Word, argumen pengirim merujuk ke dokumen. Argumen e mengacu pada argumen standar untuk suatu peristiwa, yang tidak digunakan dalam kasus ini.

Contoh kode berikut menunjukkan penanganan aktivitas default dalam proyek tingkat dokumen untuk Word.

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
}

private void ThisDocument_Shutdown(object sender, System.EventArgs e)
{
}

Contoh kode berikut menunjukkan penanganan aktivitas default dalam proyek tingkat dokumen untuk Excel.

Catatan

Contoh kode berikut menunjukkan penanganan aktivitas di Sheet1 kelas . Nama penanganan aktivitas di kelas item host lainnya sesuai dengan nama kelas. Misalnya, di Sheet2 kelas , penanganan aktivitas Startup diberi nama Sheet2_Startup. ThisWorkbook Di kelas , penanganan aktivitas Startup diberi nama ThisWorkbook_Startup.

private void Sheet1_Startup(object sender, System.EventArgs e)
{
}

private void Sheet1_Shutdown(object sender, System.EventArgs e)
{
}

Urutan peristiwa dalam proyek Excel tingkat dokumen

Penanganan aktivitas Startup di proyek Excel dipanggil dalam urutan ini:

  1. ThisWorkbook_Startup.

  2. Sheet1_Startup.

  3. Sheet2_Startup.

  4. Sheet3_Startup.

  5. Lembar lain secara berurutan.

    Penanganan aktivitas Matikan dalam solusi buku kerja dipanggil dalam urutan ini:

  6. ThisWorkbook_Shutdown.

  7. Sheet1_Shutdown.

  8. Sheet2_Shutdown.

  9. Sheet3_Shutdown.

  10. Lembar lain secara berurutan.

    Urutan ditentukan ketika proyek dikompilasi. Jika pengguna mengatur ulang lembar pada waktu proses, itu tidak mengubah urutan peristiwa dinaikkan saat berikutnya buku kerja dibuka atau ditutup.

Proyek Add-in VSTO

Visual Studio menyediakan kode yang dihasilkan di Add-in VSTO. Kode ini meningkatkan dua peristiwa yang berbeda: Startup dan Shutdown.

Peristiwa startup

Peristiwa Startup dinaikkan setelah Add-in VSTO dimuat dan semua kode inisialisasi di rakitan telah dijalankan. Kejadian ini ditangani oleh ThisAddIn_Startup metode dalam file kode yang dihasilkan.

Kode dalam ThisAddIn_Startup penanganan aktivitas adalah kode pengguna pertama yang dijalankan, kecuali Add-in VSTO Anda mengambil alih RequestComAddInAutomationService metode . Dalam hal ini, penanganan ThisAddIn_Startup aktivitas dipanggil setelah RequestComAddInAutomationService.

Jangan tambahkan kode di penanganan ThisAdd-In_Startup aktivitas jika kode mengharuskan dokumen terbuka. Sebagai gantinya, tambahkan kode tersebut ke peristiwa yang dimunculkan aplikasi Office likasi saat pengguna membuat atau membuka dokumen. Untuk informasi selengkapnya, lihat Mengakses dokumen saat aplikasi Office likasi dimulai.

Untuk informasi selengkapnya tentang urutan startup Add-in VSTO, lihat Arsitektur Add-in VSTO.

Peristiwa matikan

Peristiwa Shutdown dinaikkan ketika domain aplikasi tempat kode Anda dimuat akan dibongkar. Kejadian ini ditangani oleh ThisAddIn_Shutdown metode dalam file kode yang dihasilkan. Penanganan aktivitas ini adalah kode pengguna terakhir yang dijalankan saat Add-in VSTO dibongkar.

Peristiwa matikan di Add-in Outlook VSTO

Kejadian ini Shutdown dinaikkan hanya ketika pengguna menonaktifkan Add-in VSTO dengan menggunakan kotak dialog Add-in COM di Outlook. Ini tidak dimunculkan ketika Outlook keluar. Jika Anda memiliki kode yang harus berjalan saat Outlook keluar, tangani salah satu peristiwa berikut:

Catatan

Anda dapat memaksa Outlook untuk menaikkan Shutdown acara saat keluar dengan memodifikasi registri. Namun, jika administrator mengembalikan pengaturan ini, kode apa pun yang Anda tambahkan ke ThisAddIn_Shutdown metode tidak lagi berjalan saat Outlook keluar. Untuk informasi selengkapnya, lihat Mematikan perubahan untuk Outlook 2010.

Konten terkait