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:

Nota

Tertarik untuk mengembangkan solusi yang memperluas pengalaman Office di beberapa platform? Lihat model Add-in Office baru. Add-in untuk Office memiliki ukuran yang lebih kecil dibandingkan dengan Add-in dan solusi VSTO, serta Anda dapat membuatnya 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 berperilaku seperti objek Excel yang mereka perpanjang, tetapi mereka juga memiliki fungsionalitas tambahan seperti pembindingan data dan event 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, , Sheet1Sheet2, atau Sheet3 dari luar kelas masing-masing. Untuk informasi selengkapnya, lihat Akses global ke objek di proyek Office. Contoh berikut memanggil metode dari PrintPreview terlepas dari apakah kode ditempatkan di salah satu dari kelas Sheetn atau kelas ThisWorkbook.

Globals.Sheet1.PrintPreview();

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

  • Buku Kerja

  • lembar kerja

  • Jangkauan

    Sebagian besar pekerjaan dengan Excel berfokus pada keempat objek ini dan anggotanya.

Objek aplikasi

Objek Excel Application mewakili aplikasi Excel itu sendiri. Objek Application mengekspos banyak informasi tentang aplikasi yang sedang berjalan, opsi yang diterapkan pada instans tersebut, dan objek pengguna saat ini yang terbuka dalam instans.

Nota

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 induk 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 koleksi Sheets sebagai sebuah properti dari objek Workbook. Setiap anggota dari koleksi Sheets adalah objek Worksheet 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 lembar kerja item host.

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 objek Range dengan menyediakan tipe NamedRange 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 mendeskripsikan tipe-tipe dalam perakitan antarmuka primer 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.

Judul Description
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-tugas umum dengan rentang nilai.
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.