Panduan: Membuat Add-in VSTO pertama Anda untuk Outlook

Panduan ini memperlihatkan kepada Anda cara membuat Add-in VSTO untuk Microsoft Office Outlook. Fitur yang Anda buat dalam solusi semacam ini tersedia untuk aplikasi itu sendiri, terlepas dari item Outlook mana yang terbuka. Untuk informasi selengkapnya, lihat Gambaran umum pengembangan solusi Office (VSTO).

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek Add-in VSTO untuk Outlook. 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.

Panduan ini mengilustrasikan tugas-tugas berikut:

• Membuat proyek Add-in Outlook VSTO untuk Outlook.

• Menulis kode yang menggunakan model objek Outlook untuk menambahkan teks ke subjek dan isi pesan email baru.

• 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 Outlook

Membuat proyek

Untuk membuat proyek Outlook baru di Visual Studio

1. Mulai Visual Studio.

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

3. Di panel templat, perluas Visual C# atau Visual Basic, lalu perluas Office/SharePoint.

4. Di bawah simpul Office/SharePoint yang diperluas, pilih simpul Add-in Office.

5. Dalam daftar templat proyek, pilih proyek Add-in Outlook VSTO.

6. Dalam kotak Nama , ketik FirstOutlookAddIn.

7. Klik OK.

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

Menulis kode yang menambahkan teks ke setiap pesan email baru

Selanjutnya, tambahkan kode ke file kode ThisAddIn. Kode baru menggunakan model objek Outlook untuk menambahkan teks ke setiap pesan email baru. 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 Outlook. 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 Outlook 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 teks ke subjek dan isi setiap pesan email baru

1. Dalam file kode ThisAddIn, deklarasikan bidang bernama inspectors di ThisAddIn kelas . Bidang mempertahankan inspectors referensi ke kumpulan jendela Pemeriksa dalam instans Outlook saat ini. Referensi ini mencegah pengumpul sampah membebaskan memori yang berisi penanganan aktivitas untuk peristiwa tersebut NewInspector .

   C#

   Outlook.Inspectors inspectors;
   

   VB

   Private WithEvents inspectors As Outlook.Inspectors
   

2. Ganti metode ThisAddIn_Startup dengan kode berikut. Kode ini melampirkan penanganan aktivitas ke NewInspector peristiwa.

   C#

   private void ThisAddIn_Startup(object sender, System.EventArgs e)
   {
       inspectors = this.Application.Inspectors;
       inspectors.NewInspector +=
       new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
   }
   

   VB

   Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       inspectors = Me.Application.Inspectors
   End Sub
   

3. Dalam file kode ThisAddIn, tambahkan kode berikut ke ThisAddIn kelas . Kode ini mendefinisikan penanganan aktivitas untuk peristiwa tersebut NewInspector .

   Saat pengguna membuat pesan email baru, penanganan aktivitas ini menambahkan teks ke baris subjek dan isi pesan.

   C#

   void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
   {
       Outlook.MailItem mailItem = Inspector.CurrentItem as Outlook.MailItem;
       if (mailItem != null)
       {
           if (mailItem.EntryID == null)
           {
               mailItem.Subject = "This text was added by using code";
               mailItem.Body = "This text was added by using code";
           }
   
       }
   }
   

   VB

   Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
       Dim mailItem As Outlook.MailItem = TryCast(Inspector.CurrentItem, Outlook.MailItem)
       If Not (mailItem Is Nothing) Then
           If mailItem.EntryID Is Nothing Then
               mailItem.Subject = "This text was added by using code"
               mailItem.Body = "This text was added by using code"
           End If
       End If
   End Sub
   

   Untuk mengubah setiap pesan email baru, contoh kode sebelumnya menggunakan objek berikut:

• Bidang ApplicationThisAddIn kelas. Bidang Application mengembalikan Application objek, yang mewakili instans Outlook saat ini.

• Parameter Inspector penanganan aktivitas untuk peristiwa tersebut NewInspector . Parameter Inspector adalah Inspector objek, yang mewakili jendela Pemeriksa pesan email baru. Untuk informasi selengkapnya, lihat Solusi Outlook.

Menguji proyek

Saat Anda membuat dan menjalankan proyek, verifikasi bahwa teks muncul di baris subjek dan isi pesan email baru.

Untuk menguji proyek

1. 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 Outlook menemukan dan memuat Add-in VSTO, dan mengonfigurasi pengaturan keamanan pada komputer pengembangan untuk mengaktifkan Add-in VSTO untuk dijalankan. Untuk informasi selengkapnya, lihat Gambaran umum proses build solusi Office.

2. Di Outlook, buat pesan email baru.

3. Verifikasi bahwa teks berikut ditambahkan ke baris subjek dan isi pesan.

   Teks ini ditambahkan dengan menggunakan kode.

4. Tutup Outlook.

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 berjalan setiap kali Anda membuka Outlook di komputer pengembangan.

Untuk membersihkan proyek Anda

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

Langkah berikutnya

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

• Tugas pemrograman umum yang bisa Anda lakukan dengan menggunakan Add-in VSTO untuk Outlook. Untuk informasi selengkapnya, lihat Add-in VsTO Program.

• Menggunakan model objek Outlook. Untuk informasi selengkapnya, lihat Solusi Outlook.

• Mengkustomisasi UI Outlook, misalnya, dengan menambahkan tab kustom ke pita atau membuat panel tugas kustom Anda sendiri. Untuk informasi selengkapnya, lihat Kustomisasi Office UI.

• Membangun dan men-debug Add-in VSTO untuk Outlook. Untuk informasi selengkapnya, lihat Membangun solusi Office.

• Menyebarkan Add-in VSTO untuk Outlook. Untuk informasi selengkapnya, lihat Menyebarkan solusi Office.

Konten terkait

• Add-in VsTO Program
• Solusi Outlook
• Kustomisasi Office UI
• Membangun solusi Office
• Menyebarkan solusi Office
• Gambaran umum templat proyek Office