Panduan: Membuat kustomisasi tingkat dokumen pertama Anda untuk Excel

Panduan pengantar ini memperlihatkan kepada Anda cara membuat kustomisasi tingkat dokumen untuk Microsoft Office Excel. Fitur yang Anda buat dalam solusi semacam ini hanya tersedia saat buku kerja tertentu terbuka. Anda tidak dapat menggunakan kustomisasi tingkat dokumen untuk membuat perubahan di seluruh aplikasi, misalnya, menampilkan tab Pita baru saat buku kerja terbuka.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen untuk Excel. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Panduan ini mengilustrasikan tugas-tugas berikut:

• Membuat proyek buku kerja Excel.

• Menambahkan teks ke lembar kerja yang dihosting di perancang Visual Studio.

• Menulis kode yang menggunakan model objek Excel untuk menambahkan teks ke lembar kerja yang dikustomisasi saat dibuka.

• Membangun dan menjalankan proyek untuk mengujinya.

• Membersihkan proyek yang telah selesai untuk menghapus file build dan setelan keamanan yang tidak perlu dari komputer pengembangan Anda.

  Catatan

  Komputer Anda mungkin memperlihatkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam petunjuk berikut. Edisi Visual Studio yang Anda miliki dan setelan yang Anda gunakan menentukan elemen-elemen ini. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

• Edisi Visual Studio yang menyertakan alat pengembang Microsoft Office. Untuk informasi selengkapnya, lihat Mengonfigurasi komputer untuk mengembangkan solusi Office.

• Excel 2013 atau Excel 2010 .

Membuat proyek

Untuk membuat proyek buku kerja Excel baru di Visual Studio

1. Mulai Visual Studio.

2. Pada menu File, arahkan ke Baru, lalu klik Proyek.

3. Pada dialog Buat Proyek Baru pilih proyek Buku Kerja Excel VSTO.

   Catatan

   Anda juga bisa mencari templat dengan mengetik nama produk Office di kotak teks Pencarian di bagian atas dialog Buat Proyek Baru. Misalnya, mengetik Excel akan memperlihatkan kepada Anda semua templat proyek untuk Excel. Anda juga bisa memfilter daftar templat untuk memperlihatkan hanya templat untuk Office dengan memilih Office di kotak dropdown Jenis proyek. Untuk informasi selengkapnya, lihat Membuat proyek baru di Visual Studio.

4. Klik Berikutnya.

5. Ketik FirstWorkbookCustomization di kotak Nama pada dialog Konfigurasikan proyek baru Anda dan klik Buat.

6. Pilih Buat dokumen baru dari Wizard Visual Studio Tools for Office Project, dan klik OK.

   • Visual Studio membuat proyek FirstWorkbookCustomization , dan menambahkan file berikut ke proyek.

   • FirstWorkbookCustomization.xlsx - Mewakili buku kerja Excel dalam proyek. Berisi semua lembar kerja dan bagan.

   • Sheet1 (file.vb untuk file Visual Basic atau .cs untuk Visual C#) - Lembar kerja yang menyediakan permukaan desain dan kode untuk lembar kerja pertama dalam buku kerja. Untuk informasi selengkapnya, lihat Item host lembar kerja.

   • Lembar2 (file.vb untuk file Visual Basic atau .cs untuk Visual C#) - Lembar kerja yang menyediakan permukaan desain dan kode untuk lembar kerja kedua dalam buku kerja.

   • Lembar3 (file.vb untuk file Visual Basic atau .cs untuk Visual C#) - Lembar kerja yang menyediakan permukaan desain dan kode untuk lembar kerja ketiga dalam buku kerja.

   • ThisWorkbook (file.vb untuk file Visual Basic atau .cs untuk Visual C#) - Berisi permukaan desain dan kode untuk kustomisasi tingkat buku kerja. Untuk informasi selengkapnya, lihat Item host buku kerja.

     File kode Sheet1 dibuka secara otomatis di perancang.

Tutup dan buka kembali lembar kerja dalam perancang

Jika Anda sengaja atau tidak sengaja menutup buku kerja atau lembar kerja di perancang saat mengembangkan proyek, Anda bisa membukanya kembali.

Untuk menutup dan membuka kembali lembar kerja dalam perancang

1. Tutup buku kerja dengan mengklik tombol Tutup (X) untuk jendela perancang.

2. Di Penjelajah Solusi, klik kanan file kode Sheet1, dan klik Tampilkan Perancang.

   - atau -

   Di Penjelajah Solusi, klik dua kali file kode Sheet1.

Menambahkan teks ke lembar kerja dalam perancang

Anda bisa merancang antarmuka pengguna (UI) kustomisasi Anda dengan memodifikasi lembar kerja yang terbuka di perancang. Misalnya, Anda bisa menambahkan teks ke sel, menerapkan rumus, atau menambahkan kontrol Excel. Untuk informasi selengkapnya tentang cara menggunakan perancang, lihat Proyek Office di lingkungan Visual Studio.

Untuk menambahkan teks ke lembar kerja dengan menggunakan perancang

1. Dalam lembar kerja yang terbuka di perancang, pilih sel A1, lalu ketik teks berikut.

   Teks ini ditambahkan dengan menggunakan perancang.

Peringatan

Jika Anda menambahkan baris teks ini ke sel A2, baris tersebut akan ditimpa oleh kode lain dalam contoh ini.

Menambahkan teks ke lembar kerja secara terprogram

Selanjutnya, tambahkan kode ke file kode Sheet1. Kode baru menggunakan model objek Excel untuk menambahkan baris kedua teks ke buku kerja. Secara default, file kode Sheet1 berisi kode yang dihasilkan berikut:

• Definisi Sheet1 parsial kelas, yang mewakili model pemrograman lembar kerja dan menyediakan akses ke model objek Excel. Untuk informasi selengkapnya, Gambaran umum item host lembar kerja dan model objek Word. Sheet1 Sisa kelas ditentukan dalam file kode tersembunyi yang tidak boleh Anda ubah.

• Penanganan Sheet1_Startup aktivitas dan Sheet1_Shutdown . Penanganan aktivitas ini dipanggil saat Excel memuat dan membongkar kustomisasi Anda. Gunakan penanganan aktivitas ini untuk menginisialisasi kustomisasi Anda saat dimuat, dan untuk membersihkan sumber daya yang digunakan oleh kustomisasi Anda saat dibongkar. Untuk informasi selengkapnya, lihat Peristiwa di proyek Office.

Untuk menambahkan baris kedua teks ke lembar kerja dengan menggunakan kode

1. Di Penjelajah Solusi, klik kanan Lembar1, lalu klik Tampilkan Kode.

   File kode terbuka di Visual Studio.

2. Ganti penanganan Sheet1_Startup aktivitas dengan kode berikut. Saat Lembar1 dibuka, kode ini menambahkan baris teks kedua ke lembar kerja.

   C#

   private void Sheet1_Startup(object sender, System.EventArgs e)
   {
       Microsoft.Office.Tools.Excel.NamedRange nr =
           this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
       nr.Value2 = "This text was added by using code";
   }
   

   VB

   Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
           Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
       nr.Value2 = "This text was added by using code"
   End Sub
   

Menguji proyek

Untuk menguji buku kerja Anda

1. Tekan F5 untuk membangun dan menjalankan proyek Anda.

   Saat Anda membuat proyek, kode dikompilasi ke dalam rakitan yang terkait dengan buku kerja. Visual Studio menempatkan salinan buku kerja dan perakitan di folder output build untuk proyek, dan mengonfigurasi pengaturan keamanan pada komputer pengembangan untuk mengaktifkan penyesuaian untuk dijalankan. Untuk informasi selengkapnya, lihat Membangun solusi Office.

2. Dalam buku kerja, verifikasi bahwa Anda melihat teks berikut.

   Teks ini ditambahkan dengan menggunakan perancang.

   Teks ini ditambahkan dengan menggunakan kode.

3. Tutup buku kerja.

Membersihkan proyek

Setelah selesai mengembangkan proyek, Anda harus menghapus file di folder output build dan pengaturan keamanan yang dibuat oleh proses build.

Untuk membersihkan proyek yang telah selesai pada komputer pengembangan Anda

1. Di Visual Studio, pada menu Build , klik Bersihkan Solusi.

Langkah berikutnya

Sekarang setelah Anda membuat kustomisasi tingkat dokumen dasar untuk Excel, Anda bisa mempelajari selengkapnya tentang cara mengembangkan kustomisasi dari topik ini:

• Tugas pemrograman umum yang dapat Anda lakukan dalam kustomisasi tingkat dokumen: Kustomisasi tingkat dokumen program.

• Tugas pemrograman yang khusus untuk kustomisasi tingkat dokumen untuk Excel: Solusi Excel.

• Menggunakan model objek Excel: Gambaran umum model objek Excel.

• Mengkustomisasi UI Excel, misalnya, dengan menambahkan tab kustom ke pita atau membuat panel tindakan Anda sendiri: Kustomisasi Office UI.

• Menggunakan objek Excel yang diperluas yang disediakan oleh alat pengembangan Office di Visual Studio untuk melakukan tugas yang tidak dimungkinkan dengan menggunakan model objek Excel (misalnya, menghosting kontrol terkelola pada dokumen dan mengikat kontrol Excel ke data dengan menggunakan model pengikatan data Formulir Windows): Mengotomatiskan Excel dengan menggunakan objek yang diperluas.

• Membangun dan men-debug kustomisasi tingkat dokumen untuk Excel: Membangun solusi Office.

• Menyebarkan kustomisasi tingkat dokumen untuk Excel: Menyebarkan solusi Office.

Konten terkait

• Gambaran umum pengembangan solusi Office (VSTO)
• Solusi Excel
• Kustomisasi tingkat dokumen program
• Gambaran umum model objek Excel
• Mengotomatiskan Excel dengan menggunakan objek yang diperluas
• Kustomisasi Office UI
• Membangun solusi Office
• Menyebarkan solusi Office
• Gambaran umum templat proyek Office