Panduan: Membuat Add-in VSTO pertama Anda untuk Word

2025-06-12

Panduan pengantar ini memperlihatkan kepada Anda cara membuat Add-in VSTO untuk Microsoft Office Word. Fitur yang Anda buat dalam solusi semacam ini tersedia untuk aplikasi itu sendiri, terlepas dari dokumen mana yang terbuka.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek Add-in VSTO untuk Word. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Panduan ini mengilustrasikan tugas-tugas berikut:

Membuat proyek Add-in Word VSTO.
Menulis kode yang menggunakan model objek Word untuk menambahkan teks ke dokumen saat disimpan.
Membangun dan menjalankan proyek untuk mengujinya.
Membersihkan proyek yang telah selesai sehingga Add-in VSTO tidak lagi berjalan secara otomatis di 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.
Microsoft Word

Membuat proyek

Untuk membuat proyek Add-in Word VSTO baru di Visual Studio

Mulai Visual Studio.
Pada menu File, arahkan ke Baru, lalu klik Proyek.
Di panel templat, perluas Visual C# atau Visual Basic, lalu perluas Office/SharePoint.
Di bawah simpul Office/SharePoint yang diperluas, pilih simpul Add-in Office.
Dalam daftar templat proyek, pilih proyek Add-in Word VSTO.
Dalam kotak Nama , ketik FirstWordAddIn.
Klik OK.

Visual Studio membuat proyek FirstWordAddIn dan membuka file kode ThisAddIn di editor.

Menulis kode untuk menambahkan teks ke dokumen yang disimpan

Selanjutnya, tambahkan kode ke file kode ThisAddIn. Kode baru menggunakan model objek Word untuk menambahkan teks boilerplate ke setiap dokumen yang disimpan. Secara default, file kode ThisAddIn berisi kode yang dihasilkan berikut:

Definisi parsial kelas ThisAddIn . Kelas ini menyediakan titik masuk untuk kode Anda dan menyediakan akses ke model objek Word. Untuk informasi selengkapnya, lihat Add-in VsTO Program. ThisAddIn Sisa kelas ditentukan dalam file kode tersembunyi yang tidak boleh Anda ubah.
Penanganan ThisAddIn_Startup aktivitas dan ThisAddIn_Shutdown . Penanganan aktivitas ini dipanggil saat Word memuat dan membongkar Add-in VSTO Anda. Gunakan penanganan aktivitas ini untuk menginisialisasi Add-in VSTO Anda saat dimuat, dan untuk membersihkan sumber daya yang digunakan oleh Add-in VSTO Anda saat dibongkar. Untuk informasi selengkapnya, lihat Peristiwa di proyek Office.

Untuk menambahkan paragraf teks ke dokumen yang disimpan

Dalam file kode ThisAddIn, tambahkan kode berikut ke ThisAddIn kelas . Kode baru mendefinisikan penanganan aktivitas untuk DocumentBeforeSave peristiwa, yang dinaikkan saat dokumen disimpan.

Saat pengguna menyimpan dokumen, penanganan aktivitas menambahkan teks baru di awal dokumen.
- C#
- VB
```
void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}
```
```
Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code."
End Sub
```
Catatan

Kode ini menggunakan nilai indeks 1 untuk mengakses paragraf pertama dalam Paragraphs koleksi. Meskipun Visual Basic dan Visual C# menggunakan array berbasis 0, batas array yang lebih rendah dari sebagian besar koleksi dalam model objek Word adalah 1. Untuk informasi selengkapnya, lihat Menulis kode di solusi Office.
Jika Anda menggunakan C#, tambahkan kode yang diperlukan berikut ke penanganan ThisAddIn_Startup aktivitas. Kode ini digunakan untuk menyambungkan Application_DocumentBeforeSave penanganan aktivitas dengan DocumentBeforeSave peristiwa.
```
this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);
```
Untuk mengubah dokumen saat disimpan, contoh kode sebelumnya menggunakan objek berikut:

Bidang Application ThisAddIn kelas. Bidang Application mengembalikan Application objek, yang mewakili instans Word saat ini.
Parameter Doc penanganan aktivitas untuk peristiwa tersebut DocumentBeforeSave . Parameter Doc adalah Document objek, yang mewakili dokumen yang disimpan. Untuk informasi selengkapnya, lihat Gambaran umum model objek Word.

Menguji proyek

Untuk menguji proyek

Tekan F5 untuk membangun dan menjalankan proyek Anda.

Saat Anda membangun proyek, kode dikompilasi ke dalam rakitan yang disertakan dalam folder output build untuk proyek. Visual Studio juga membuat sekumpulan entri registri yang memungkinkan Word menemukan dan memuat Add-in VSTO, dan mengonfigurasi pengaturan keamanan pada komputer pengembangan untuk mengaktifkan Add-in VSTO untuk dijalankan. Untuk informasi selengkapnya, lihat Membangun solusi Office.
Di Word, simpan dokumen aktif.
Verifikasi bahwa teks berikut ditambahkan ke dokumen.

Teks ini ditambahkan dengan menggunakan kode.
Tutup Kata.

Membersihkan proyek

Setelah Anda selesai mengembangkan proyek, hapus rakitan Add-in VSTO, entri registri, dan pengaturan keamanan dari komputer pengembangan Anda. Jika tidak, Add-in VSTO akan terus berjalan setiap kali Anda membuka Word di komputer pengembangan Anda.

Untuk membersihkan proyek yang telah selesai pada komputer pengembangan Anda

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

Langkah berikutnya

Sekarang setelah Anda membuat Add-in VSTO dasar untuk Word, Anda bisa mempelajari selengkapnya tentang cara mengembangkan Add-in VSTO dari topik ini:

Tugas pemrograman umum yang dapat Anda lakukan di Add-in VSTO: Add-in VsTO Program.
Tugas pemrograman yang khusus untuk Add-in Word VSTO: Solusi Word.
Menggunakan model objek Word: Gambaran umum model objek Word.
Mengkustomisasi UI Word, misalnya, dengan menambahkan tab kustom ke Pita atau membuat panel tugas kustom Anda sendiri: Kustomisasi Office UI.
Membuat dan men-debug Add-in VSTO untuk Word: Membangun solusi Office.
Menyebarkan Add-in VSTO untuk Word: Menyebarkan solusi Office.