Item host buku kerja
Item Workbook host adalah jenis yang memperluas Workbook jenis dari rakitan interop utama untuk Excel. Item Workbook host menyediakan semua properti, metode, dan peristiwa yang sama sebagai Workbook objek, tetapi juga menyediakan fitur tambahan.
Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO untuk Excel. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.
Dalam proyek tingkat dokumen, ada item host default Workbook yang mewakili buku kerja dalam proyek Anda. Di proyek Add-in VSTO, Anda dapat menghasilkan Workbook item host pada waktu proses.
Memahami item host buku kerja dalam proyek tingkat dokumen
Untuk mengakses buku kerja di proyek Anda, gunakan ThisWorkbook kelas . Kelas memberi ThisWorkbook Anda akses ke anggota Workbook item host untuk melakukan tugas dasar dalam penyesuaian Anda, seperti menjalankan kode saat buku kerja dibuka atau ditutup. Untuk informasi selengkapnya, lihat Kustomisasi tingkat dokumen program.
Kelas ThisWorkbook ini menyediakan lokasi di mana Anda dapat mulai menulis kode dalam proyek Anda. Karena kelas menyediakan semua properti, metode, dan peristiwa yang sama dengan Workbook objek dalam rakitan interop utama untuk Excel, Anda juga dapat menggunakan ThisWorkbook untuk mengakses model objek Excel. Untuk informasi selengkapnya, lihat Gambaran umum model objek Excel.
Klik dua kali item proyek ThisWorkbook di Penjelajah Solusi untuk menampilkan perancang buku kerja dan untuk menampilkan properti dan peristiwa buku kerja di jendela Properti.
Batasan item host buku kerja dalam proyek tingkat dokumen
Proyek tingkat dokumen hanya dapat berisi satu Workbook item host (yaitu, ThisWorkbook kelas ). Anda tidak dapat menambahkan item host baru Workbook ke proyek Anda pada waktu desain, dan Anda tidak dapat membuat item host baru Workbook pada waktu proses dari penyesuaian tingkat dokumen.
Jika Anda membuat buku kerja Excel baru pada waktu proses, buku kerja tersebut akan berjenis Workbook. Karena bukan item host, item tidak boleh berisi kontrol host atau kontrol Formulir Windows. Untuk informasi selengkapnya tentang membuat buku kerja pada waktu proses, lihat Cara: Membuat buku kerja baru secara terprogram.
Item Workbook host tidak bertindak sebagai kontainer untuk kontrol host. Oleh karena itu, Anda tidak dapat menambahkan kontrol yang terlihat ke buku kerja, tetapi Anda bisa menambahkan komponen, seperti DataSet, sehingga komponen dapat dibagikan oleh semua lembar kerja. Dalam proyek tingkat dokumen, komponen yang tersedia untuk buku kerja dapat ditemukan pada tab Komponen, tab Data, dan tab Semua Formulir Windows kotak Alat.
Catatan
Alat pengembangan Office di Visual Studio tidak mendukung buku kerja bersama.
Memahami item host buku kerja di proyek Add-in VSTO
Di proyek Add-in VSTO, Anda bisa membuat Workbook item host pada waktu proses untuk buku kerja apa pun yang terbuka di Excel. Untuk menghasilkan Workbook item host, gunakan GetVstoObject metode . Untuk informasi selengkapnya, lihat Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses.