Bagikan melalui


Rakitan interop utama Office

Untuk menggunakan fitur Microsoft aplikasi Office lication dari proyek Office, Anda harus menggunakan perakitan interop utama (PIA) untuk aplikasi. PIA memungkinkan kode terkelola berinteraksi dengan model objek berbasis COM Microsoft aplikasi Office lication.

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.

Saat Anda membuat proyek Office baru, Visual Studio menambahkan referensi ke PIA yang diperlukan untuk membangun proyek. Dalam beberapa skenario, Anda mungkin perlu menambahkan referensi ke PIA lain (misalnya, Anda bisa menggunakan fitur Microsoft Office Word dalam proyek untuk Microsoft Office Excel).

Artikel ini menjelaskan aspek-aspek berikut menggunakan MICROSOFT Office PIAs dalam proyek Office:

Untuk informasi selengkapnya tentang rakitan interop utama, lihat rakitan interop utama.

Pisahkan rakitan interop utama untuk membangun dan menjalankan proyek

Visual Studio menggunakan set PIA yang berbeda di komputer pengembangan. Kumpulan rakitan yang berbeda ini berada di lokasi berikut:

  • Folder dalam direktori file program

    Kumpulan rakitan ini digunakan saat Anda menulis kode dan membangun proyek. Visual Studio menginstal rakitan ini secara otomatis.

  • Cache perakitan global

    Kumpulan rakitan ini digunakan selama beberapa tugas pengembangan, seperti saat Anda menjalankan atau men-debug proyek. Visual Studio tidak menginstal dan mendaftarkan rakitan ini; Kau harus melakukannya sendiri.

Rakitan interop utama dalam direktori file program

PIA secara otomatis ditambahkan ke lokasi dalam sistem file, di luar cache perakitan global, saat Anda menginstal Visual Studio. Saat Anda membuat proyek baru, Visual Studio secara otomatis menambahkan referensi ke salinan PIA ini ke proyek Anda. Visual Studio menggunakan salinan PIA ini, alih-alih rakitan di cache perakitan global, untuk mengatasi referensi jenis saat Anda mengembangkan dan membangun proyek Anda.

Ketika berbagai versi PIA terdaftar di cache perakitan global, Anda dapat menghadapi beberapa masalah pengembangan. Salinan PIA yang ditambahkan akan membantu Anda menghindari masalah tersebut.

Untuk Visual Studio 2017 dan yang lebih baru, salinan PIA ini diinstal ke lokasi bersama berikut di komputer pengembangan:

  • %ProgramFiles%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\

  • (atau %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ pada sistem operasi 64-bit)

Catatan

Untuk versi Visual Studio yang lebih lama, PIA ini akan diinstal ke folder Visual Studio Tools for Office\PIA di bawah folder untuk versi Visual Studio tersebut %ProgramFiles% . Sebagai contoh: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Rakitan interop utama di cache perakitan global

Untuk melakukan tugas pengembangan tertentu, PIA harus diinstal dan didaftarkan dalam cache perakitan global pada komputer pengembangan. Biasanya, PIA diinstal secara otomatis saat Anda menginstal Office di komputer pengembangan. Untuk informasi selengkapnya, lihat Mengonfigurasi komputer untuk mengembangkan solusi Office.

PIA Office tidak diperlukan di komputer pengguna akhir untuk menjalankan solusi Office. Untuk informasi selengkapnya, lihat Mendesain dan membuat solusi Office.

Menggunakan fitur beberapa aplikasi Office likasi Microsoft dalam satu proyek

Setiap templat proyek Office di Visual Studio dirancang untuk bekerja dengan satu microsoft aplikasi Office likasi. Untuk menggunakan fitur dalam beberapa microsoft aplikasi Office lications, atau untuk menggunakan fitur dalam aplikasi atau komponen yang tidak memiliki proyek di Visual Studio, Anda harus menambahkan referensi ke PIA yang diperlukan.

Dalam kebanyakan kasus, Anda harus menambahkan referensi ke PIA yang diinstal oleh Visual Studio di %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ bawah direktori. Versi rakitan ini muncul di tab Kerangka Kerja dari kotak dialog Manajer Referensi. Untuk informasi selengkapnya, lihat Cara: Target aplikasi Office likasi melalui rakitan interop utama.

Jika Anda telah menginstal dan mendaftarkan PIA di cache perakitan global, versi rakitan ini muncul di tab COM dari kotak dialog Manajer Referensi. Hindari menambahkan referensi ke versi rakitan ini, karena ada beberapa masalah pengembangan yang dapat terjadi saat Anda menggunakannya. Misalnya, jika Anda telah mendaftarkan versi PIA yang berbeda di cache perakitan global, proyek Anda akan secara otomatis mengikat versi rakitan yang terdaftar terakhir, bahkan jika Anda menentukan versi perakitan yang berbeda pada tab COM dari kotak dialog Manajer Referensi.

Catatan

Beberapa rakitan ditambahkan ke proyek secara otomatis ketika rakitan yang mereferensikannya ditambahkan. Misalnya, referensi ke Office.dll rakitan dan Microsoft.Vbe.Interop.dll ditambahkan secara otomatis saat Anda menambahkan referensi ke rakitan Word, Excel, Outlook, Microsoft Forms, atau Graph.

Rakitan interop utama untuk Microsoft aplikasi Office lications

Tabel berikut ini mencantumkan rakitan interop utama yang tersedia untuk Office 2016, Office 2013, dan Office 2010.


aplikasi Office likasi atau komponen Nama rakitan interop utama
Pustaka Objek Microsoft Access 14.0

Pustaka Objek Microsoft Access 15.0
Microsoft.Office.Interop.Access.dll
Pustaka Objek Mesin Database Access Microsoft Office 14.0

Pustaka Objek Mesin Database Access Microsoft Office 15.0
Microsoft.Office.Interop.Access.Dao.dll
Pustaka Objek Microsoft Excel 14.0

Pustaka Objek Microsoft Excel 15.0
Microsoft.Office.Interop.Excel.dll
Pustaka Objek Microsoft Graph 14.0 (digunakan oleh PowerPoint, Access, dan Word untuk grafik)

Pustaka Objek Microsoft Graph 15.0
Microsoft.Office.Interop.Graph.dll
Pustaka Jenis Microsoft InfoPath 2.0 (hanya untuk InfoPath 2007) Microsoft.Office.Interop.InfoPath.dll
Microsoft InfoPath XML Interop Assembly (hanya untuk InfoPath 2007) Microsoft.Office.Interop.InfoPath.Xml.dll
Pustaka Objek Microsoft Office 14.0 (fungsionalitas bersama Office)

Pustaka Objek Microsoft Office 15.0 (fungsionalitas bersama Office)
office.dll
Kontrol Tampilan Microsoft Office Outlook (dapat digunakan di halaman Web dan aplikasi untuk mengakses Kotak Masuk Anda) Microsoft.Office.Interop.OutlookViewCtl.dll
Pustaka Objek Microsoft Outlook 14.0

Pustaka Objek Microsoft Outlook 15.0
Microsoft.Office.Interop.Outlook.dll
Pustaka Objek Microsoft PowerPoint 14.0

Pustaka Objek Microsoft PowerPoint 15.0
Microsoft.Office.Interop.PowerPoint.dll
Pustaka Objek Microsoft Project 14.0

Pustaka Objek Microsoft Project 15.0
Microsoft.Office.Interop.MSProject.dll
Pustaka Objek Microsoft Publisher 14.0

Pustaka Objek Microsoft Publisher 15.0
Microsoft.Office.Interop.Publisher.dll
Pustaka Referensi Objek Web Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesigner.dll
Pustaka Referensi Objek Halaman Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesignerPage.dll
Catatan Pustaka Tipe Microsoft Smart Tags 2.0: Tag pintar tidak digunakan lagi di Excel 2010 dan Word 2010. Microsoft.Office.Interop.SmartTag.dll
Pustaka Tipe Microsoft Visio 14.0

Pustaka Tipe Microsoft Visio 15.0
Microsoft.Office.Interop.Visio.dll
Microsoft Visio 14.0 Simpan Sebagai Pustaka Tipe Web

Microsoft Visio 15.0 Simpan Sebagai Pustaka Tipe Web
Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Pustaka Tipe Kontrol Gambar Microsoft Visio 14.0

Pustaka Tipe Kontrol Gambar Microsoft Visio 15.0
Microsoft.Office.Interop.VisOcx.dll
Pustaka Objek Microsoft Word 14.0

Pustaka Objek Microsoft Word 15.0
Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic untuk Ekstensibilitas Aplikasi 5.3 Microsoft.Vbe.Interop.dll

Mengikat rakitan pengalihan

Saat Anda menginstal dan mendaftarkan PIA Office di singgahan rakitan global (baik dengan Office atau dengan menginstal paket yang dapat didistribusikan ulang untuk PIA), rakitan pengalihan pengikatan juga diinstal hanya di singgahan rakitan global. Rakitan ini memastikan bahwa versi rakitan interop utama yang benar dimuat pada waktu proses.

Misalnya, ketika solusi yang mereferensikan rakitan Office 2010 berjalan di komputer yang memiliki versi Office 2013 dari rakitan interop utama yang sama, rakitan pengalihan pengikatan menginstruksikan runtime .NET Framework untuk memuat versi Office 2013 dari rakitan interop utama.

Untuk informasi selengkapnya, lihat Cara: Mengaktifkan dan menonaktifkan pengalihan pengikatan otomatis.