Bagikan melalui

Item host lembar kerja

  • Artikel

Item Worksheet host adalah jenis yang memperluas Worksheet jenis dari rakitan interop utama untuk Excel. Item Worksheet host menyediakan semua properti, metode, dan peristiwa yang sama sebagai Worksheet objek, tetapi juga mengekspos peristiwa tambahan dan bertindak sebagai kontainer untuk kontrol host dan kontrol Formulir Windows.

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, Anda dapat menambahkan Worksheet item host ke proyek Anda pada waktu desain. Di proyek Add-in VSTO, Anda dapat menghasilkan Worksheet item host pada waktu proses.

Memahami item host lembar kerja dalam proyek tingkat dokumen

Saat Anda membuat proyek tingkat dokumen untuk Excel, Visual Studio secara otomatis membuat tiga Worksheet item host dalam proyek. Nama default lembar kerja adalah Sheet1, , Sheet2dan Sheet3. Jika Anda membuat proyek berdasarkan buku kerja yang sudah ada, jumlah item host bergantung pada jumlah lembar kerja dalam buku kerja.

Kelas lembar kerja ini memberi Anda akses ke anggota Worksheet item host untuk melakukan tugas dasar dalam kustomisasi Anda, seperti mengubah konten lembar kerja. Anda juga bisa menggunakan kelas ini untuk menambahkan kontrol ke lembar kerja. Dengan menggabungkan serangkaian kontrol yang berbeda dan menulis kode, Anda dapat mengikat kontrol ke data, mengumpulkan informasi dari pengguna, dan menanggapi tindakan pengguna. Untuk informasi selengkapnya, lihat Kustomisasi tingkat dokumen program.

Kelas lembar kerja menyediakan lokasi di mana Anda bisa mulai menulis kode dalam proyek Anda. Karena kelas menyediakan semua properti, metode, dan peristiwa yang sama dengan Worksheet objek dalam rakitan interop utama untuk Excel, Anda juga dapat menggunakan kelas ini untuk mengakses model objek Excel. Untuk informasi selengkapnya, lihat Gambaran umum model objek Excel.

Dalam proyek tingkat dokumen, Anda bisa menambahkan item host tambahan Worksheet ke proyek pada waktu desain dengan menambahkan lembar kerja baru ke buku kerja dalam perancang.

Mengganti nama lembar kerja

Dalam proyek tingkat dokumen, Anda bisa mengganti nama lembar kerja di perancang Visual Studio, tetapi ini hanya mengubah nama tampilan lembar kerja. Nama terprogram masih merupakan nama default lembar kerja. Jika Anda mengganti nama lembar kerja di jendela Properti , hanya nama terprogram yang diubah.

Batasan item host lembar kerja dalam proyek tingkat dokumen

Anda tidak dapat membuat item host baru Worksheet pada waktu proses dalam proyek tingkat dokumen. Jika Anda membuat lembar kerja Excel baru pada waktu proses, lembar kerja tersebut akan berjenis Worksheet. Karena bukan item host, item tidak boleh berisi kontrol host atau kontrol Formulir Windows. Untuk informasi selengkapnya tentang membuat dokumen pada waktu proses, lihat Cara: Menambahkan lembar kerja baru secara terprogram ke buku kerja.

Memahami item host lembar kerja dalam proyek Add-in VSTO

Dalam proyek tingkat aplikasi, Anda bisa membuat Worksheet item host pada waktu proses untuk lembar kerja apa pun yang terbuka di Excel. Anda bisa menggunakan Worksheet item host untuk menambahkan kontrol ke lembar kerja terkait, atau untuk menangani peristiwa yang tidak tersedia pada Worksheet objek.

Untuk menghasilkan Worksheet item host, gunakan GetVstoObject metode . Untuk informasi selengkapnya, lihat Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses.

Konten terkait