Gambaran umum model objek Excel
Untuk mengembangkan solusi yang menggunakan Microsoft Office Excel, Anda bisa berinteraksi dengan objek yang disediakan oleh model objek Excel. Topik ini memperkenalkan objek yang paling penting:
-
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.
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.
Model objek mengikuti antarmuka pengguna dengan erat. Objek Application mewakili seluruh aplikasi, dan setiap Workbook objek berisi kumpulan Worksheet
objek. Dari sana, abstraksi utama yang mewakili sel adalah Range objek, yang memungkinkan Anda bekerja dengan sel atau grup sel individual.
Selain model objek Excel, proyek Office di Visual Studio menyediakan item host dan kontrol host yang memperluas beberapa objek dalam model objek Excel. Item host dan kontrol host berpura-pura seperti objek Excel yang mereka perluas, tetapi mereka juga memiliki fungsionalitas tambahan seperti kemampuan pengikatan data dan peristiwa tambahan. Untuk informasi selengkapnya, lihat Mengotomatiskan Excel dengan menggunakan objek yang diperluas dan Gambaran umum item host dan kontrol host.
Topik ini menyediakan gambaran umum singkat tentang model objek Excel. Untuk sumber daya di mana Anda bisa mempelajari selengkapnya tentang seluruh model objek Excel, lihat Menggunakan dokumentasi model objek Excel.
Mengakses objek dalam proyek Excel
Saat Anda membuat proyek Add-in VSTO baru untuk Excel, Visual Studio secara otomatis membuat file kode ThisAddIn.vb atau ThisAddIn.cs . Anda dapat mengakses objek Aplikasi dengan menggunakan Me.Application
atau this.Application
.
Saat Anda membuat proyek tingkat dokumen baru untuk Excel, Anda memiliki opsi untuk membuat proyek Buku Kerja Excel atau Templat Excel baru. Visual Studio secara otomatis membuat file kode berikut di proyek Excel baru Anda untuk proyek buku kerja dan templat.
Visual Basic | C# |
---|---|
ThisWorkbook.vb | ThisWorkbook.cs |
Sheet1.vb | Sheet1.cs |
Sheet2.vb | Sheet2.cs |
Sheet3.vb | Sheet3.cs |
Anda dapat menggunakan Globals
kelas dalam proyek Anda untuk mengakses ThisWorkbook
, , Sheet1
Sheet2
, atau Sheet3
dari luar kelas masing-masing. Untuk informasi selengkapnya, lihat Akses global ke objek di proyek Office. Contoh berikut memanggil PrintPreview metode terlepas dari Sheet1
apakah kode ditempatkan di salah Sheet
satu kelas n atau ThisWorkbook
kelas.
Karena data dalam dokumen Excel sangat terstruktur, model objek bersifat hierarkis dan mudah. Excel menyediakan ratusan objek yang mungkin ingin Anda berinteraksi, tetapi Anda bisa mendapatkan awal yang baik pada model objek dengan berfokus pada subset kecil objek yang tersedia. Objek-objek ini mencakup empat berikut:
Aplikasi
Workbook
Lembar kerja
Rentang
Sebagian besar pekerjaan dilakukan dengan pusat Excel di sekitar empat objek ini dan anggotanya.
Objek aplikasi
Objek Excel Application mewakili aplikasi Excel itu sendiri. Objek mengekspos Application banyak informasi tentang aplikasi yang sedang berjalan, opsi yang diterapkan ke instans tersebut, dan objek pengguna saat ini terbuka dalam instans.
Catatan
Anda tidak boleh mengatur EnableEvents properti Application objek di Excel ke false. Mengatur properti ini ke false mencegah Excel menaikkan kejadian apa pun, termasuk kejadian kontrol host.
Objek buku kerja
Objek Workbook mewakili satu buku kerja dalam aplikasi Excel.
Alat pengembangan Office di Visual Studio memperluas Workbook objek dengan menyediakan jenisnya Workbook . Jenis ini memberi Anda akses ke semua fitur Workbook objek. Untuk informasi selengkapnya, lihat Item host buku kerja.
Objek lembar kerja
Objek Worksheet adalah anggota Worksheets koleksi. Banyak properti, metode, dan peristiwa Worksheet yang identik atau mirip dengan anggota yang disediakan oleh Application objek atau Workbook .
Excel menyediakan Sheets koleksi sebagai properti Workbook objek. Setiap anggota Sheets koleksi adalah Worksheet objek atau Chart .
Alat pengembangan Office di Visual Studio memperluas Worksheet objek dengan menyediakan jenisnya Worksheet . Jenis ini memberi Anda akses ke semua fitur Worksheet objek, serta fitur baru seperti kemampuan untuk menghosting kontrol terkelola dan menangani peristiwa baru. Untuk informasi selengkapnya, lihat Item host lembar kerja.
Objek rentang
Objek Range adalah objek yang paling sering Anda gunakan dalam aplikasi Excel Anda. Sebelum bisa memanipulasi wilayah mana pun dalam Excel, Anda harus mengekspresikannya sebagai Range objek dan bekerja dengan metode dan properti rentang tersebut. Objek Range mewakili sel, baris, kolom, pilihan sel yang berisi satu atau beberapa blok sel, yang mungkin atau mungkin tidak berdampingan, atau bahkan sekelompok sel pada beberapa lembar.
Visual Studio memperluas Range objek dengan menyediakan NamedRange jenis dan XmlMappedRange . Jenis ini memiliki sebagian besar fitur yang sama dengan Range objek, serta fitur baru seperti kemampuan pengikatan data dan peristiwa baru. Untuk informasi selengkapnya, lihat Kontrol namedRange dan kontrol XmlMappedRange.
Menggunakan dokumentasi model objek Excel
Untuk informasi lengkap tentang model objek Excel, Anda bisa merujuk ke referensi perakitan interop utama Excel (PIA) dan referensi model objek VBA.
Referensi perakitan interop utama
Dokumentasi referensi PIA Excel menjelaskan tipe dalam perakitan interop utama untuk Excel. Dokumentasi ini tersedia dari lokasi berikut: Referensi perakitan interop utama Excel 2010.
Untuk informasi selengkapnya tentang desain Pia Excel, seperti perbedaan antara kelas dan antarmuka di PIA dan bagaimana peristiwa di PIA diterapkan, lihat Gambaran umum kelas dan antarmuka di rakitan interop utama Office.
Referensi model objek VBA
Model objek VBA mereferensikan dokumen model objek Excel saat diekspos ke kode Visual Basic for Applications (VBA). Untuk informasi selengkapnya, lihat Referensi model objek Excel 2010.
Semua objek dan anggota dalam referensi model objek VBA sesuai dengan tipe dan anggota di Pia Excel. Misalnya, objek Lembar Kerja dalam referensi model objek VBA sesuai dengan Worksheet objek di Pia Excel. Meskipun referensi model objek VBA menyediakan contoh kode untuk sebagian besar properti, metode, dan peristiwa, Anda harus menerjemahkan kode VBA dalam referensi ini ke Visual Basic atau Visual C# jika Anda ingin menggunakannya dalam proyek Excel yang Anda buat dengan menggunakan Visual Studio.
Topik terkait
Judul | Deskripsi |
---|---|
Solusi Excel | Menjelaskan cara membuat kustomisasi tingkat dokumen dan Add-in VSTO untuk Microsoft Office Excel. |
Bekerja dengan rentang | Menyediakan contoh yang menunjukkan cara melakukan tugas umum dengan rentang. |
Bekerja dengan lembar kerja | Menyediakan contoh yang memperlihatkan cara melakukan tugas umum dengan lembar kerja. |
Bekerja dengan buku kerja | Menyediakan contoh yang memperlihatkan cara melakukan tugas umum dengan buku kerja. |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk