Bagikan melalui

Gambaran umum model objek Outlook

  • Artikel

Untuk mengembangkan Add-in VSTO untuk Microsoft Office Outlook, Anda bisa berinteraksi dengan objek yang disediakan oleh model objek Outlook. Model objek Outlook menyediakan kelas dan antarmuka yang mewakili item di antarmuka pengguna. Misalnya, Application objek mewakili seluruh aplikasi, Folder objek mewakili folder yang berisi pesan email atau item lain, dan MailItem objek mewakili pesan email.

Topik ini memberikan gambaran singkat tentang beberapa objek utama dalam model objek Outlook. Untuk sumber daya di mana Anda bisa mempelajari selengkapnya tentang seluruh model objek Outlook, lihat Menggunakan dokumentasi model objek Outlook.

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.

Mengakses objek dalam proyek Outlook

Outlook menyediakan banyak objek yang dapat Anda berinteraksi. Untuk menggunakan model objek secara efektif, Anda harus terbiasa dengan objek tingkat atas berikut:

Objek aplikasi

Objek Application mewakili aplikasi Outlook, dan merupakan objek tingkat tertinggi dalam model objek Outlook. Beberapa anggota terpenting dari objek ini meliputi:

  • Metode CreateItem yang bisa Anda gunakan untuk membuat item baru seperti pesan email, tugas, atau janji temu.

  • Properti Explorers , yang bisa Anda gunakan untuk mengakses jendela yang menampilkan konten folder di antarmuka pengguna (UI) Outlook.

  • Properti Inspectors , yang bisa Anda gunakan untuk mengakses jendela yang menampilkan konten item tunggal, seperti pesan email atau permintaan rapat.

    Untuk mendapatkan instans Application objek, gunakan bidang Aplikasi kelas ThisAddIn di proyek Anda. Untuk informasi selengkapnya, lihat Add-in VsTO Program.

Catatan

Untuk membantu menghindari peringatan keamanan saat Anda menggunakan properti dan metode yang diblokir oleh penjaga model objek Outlook, dapatkan objek Outlook dari bidang Aplikasi kelas ThisAddIn . Untuk informasi selengkapnya, lihat Pertimbangan keamanan tertentu untuk solusi Office.

Objek penjelajah

Objek Explorer mewakili jendela yang menampilkan isi folder yang berisi item seperti pesan email, tugas, atau janji temu. Objek Explorer mencakup metode dan properti yang dapat Anda gunakan untuk mengubah jendela, dan peristiwa yang dinaikkan saat jendela berubah.

Untuk mendapatkan Explorer objek, lakukan salah satu hal berikut ini:

Objek pemeriksa

Objek Inspector mewakili jendela yang menampilkan satu item seperti pesan email, tugas, atau janji temu. Objek Inspector mencakup metode dan properti yang dapat Anda gunakan untuk mengubah jendela, dan peristiwa yang dinaikkan saat jendela berubah.

Untuk mendapatkan Inspector objek, lakukan salah satu hal berikut ini:

Objek folder

Objek Folder mewakili folder yang berisi pesan email, kontak, tugas, dan item lainnya. Outlook menyediakan 16 objek default Folder .

Objek default Folder ditentukan oleh OlDefaultFolders nilai enumerasi. Contohnya,

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox sesuai dengan folder Kotak Masuk di Outlook.

Untuk contoh yang memperlihatkan cara mengakses default Folder dan membuat baru Folder, lihat Cara: Membuat item folder kustom secara terprogram.

Objek MailItem

Objek MailItem mewakili pesan email. MailItemobjek biasanya berada di folder, seperti Kotak Masuk, Item Terkirim, dan Kotak Keluar. MailItem mengekspos properti dan metode yang dapat digunakan untuk membuat dan mengirim pesan email.

Untuk contoh yang memperlihatkan cara membuat pesan email, lihat Cara: Membuat item email secara terprogram.

Objek AppointmentItem

Objek AppointmentItem mewakili rapat, janji temu satu kali, atau janji temu atau rapat berulang di folder Kalender . Objek AppointmentItem menyertakan metode yang melakukan tindakan seperti merespons atau meneruskan permintaan rapat, dan properti yang menentukan detail rapat seperti lokasi dan waktu.

Untuk contoh yang memperlihatkan cara membuat janji temu, lihat Cara: Membuat permintaan rapat secara terprogram.

Objek TaskItem

Objek TaskItem mewakili tugas yang akan dilakukan dalam jangka waktu tertentu. TaskItem objek terletak di folder Tugas .

Untuk membuat tugas, gunakan metode CreateItem objek Application , dan teruskan nilai olTaskItem untuk parameter .

Objek ContactItem

Objek ContactItemmewakili kontak di folder Kontak . ContactItem objek berisi berbagai informasi kontak untuk orang yang mereka wakili, seperti alamat jalan, alamat email, dan nomor telepon.

Untuk contoh yang memperlihatkan cara membuat kontak baru, lihat Cara: Menambahkan entri secara terprogram ke kontak Outlook. Untuk contoh yang memperlihatkan cara mencari kontak yang sudah ada, lihat Cara: Mencari kontak tertentu secara terprogram.

Menggunakan dokumentasi model objek Outlook

Untuk informasi lengkap tentang model objek Outlook, Anda bisa merujuk ke referensi perakitan interop utama Outlook (PIA) dan referensi model objek VBA.

Referensi perakitan interop utama

Referensi PIA Outlook mencakup tipe dalam rakitan interop utama untuk Outlook 2010. Untuk informasi selengkapnya, lihat Referensi perakitan interop utama Outlook 2010.

Selain memberikan informasi untuk semua jenis dalam PIA, dokumentasi ini juga menyediakan informasi tambahan tentang struktur PIA dan contoh kode untuk tugas otomatisasi Outlook umum.

Referensi model objek VBA

Model objek VBA mereferensikan dokumen model objek Outlook karena diekspos ke kode Visual Basic for Applications (VBA). Untuk informasi selengkapnya, lihat Referensi model objek Outlook 2010.

Semua objek dan anggota dalam referensi model objek VBA sesuai dengan jenis dan anggota di PIA Outlook. Misalnya, objek Pemeriksa dalam referensi model objek VBA sesuai dengan Inspector objek di Pia Outlook. 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 Add-In Outlook VSTO yang Anda buat dengan menggunakan Visual Studio.

Judul Deskripsi
Bekerja dengan item kontak Menyediakan topik yang menunjukkan cara melakukan tugas dengan kontak.
Bekerja dengan item email Menyediakan topik yang memperlihatkan cara melakukan tugas dengan item email.
Bekerja dengan folder Menyediakan topik yang memperlihatkan cara melakukan tugas dengan folder.
Bekerja dengan item kalender Menyediakan topik yang memperlihatkan cara melakukan tugas dengan item kalender.
Cara: Menentukan item Outlook saat ini secara terprogram Memperlihatkan cara menampilkan nama folder saat ini dan beberapa informasi tentang item terpilih.