Bagikan melalui

Mendesain dan membuat solusi Office

  • Artikel

Visual Studio menyediakan templat proyek yang bisa Anda gunakan untuk membuat beberapa jenis solusi Office yang berbeda. Bagian dokumentasi ini menjelaskan templat proyek dan menyediakan panduan tentang membuat proyek Office. Untuk informasi tentang cara menerapkan kustomisasi kode dan antarmuka pengguna setelah Anda membuat proyek, lihat Mengembangkan solusi Office.

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

Membuat proyek Office

Sebelum memulai, Anda harus menentukan kebutuhan Anda dan menemukan jenis solusi yang menawarkan yang paling cocok. Misalnya, jika solusi Office Anda harus berjalan setiap kali aplikasi digunakan, Add-in VSTO paling sesuai dengan kebutuhan Anda. Jika kode terintegrasi erat dengan satu dokumen, buat kustomisasi tingkat dokumen. Jenis proyek ini tersedia sebagai templat proyek Visual Studio. Untuk informasi selengkapnya tentang templat proyek Office yang disertakan dengan Visual Studio, lihat Gambaran umum templat proyek Office. Untuk informasi selengkapnya tentang cara membuat proyek Office, lihat Cara: Membuat proyek Office di Visual Studio.

Proyek Office memiliki fitur dan item proyek yang berbeda dari jenis proyek lain di Visual Studio. Misalnya, saat Anda membuat proyek tingkat dokumen, dokumen atau buku kerja di proyek Anda dapat dibuka dan diedit di dalam Visual Studio. Untuk informasi selengkapnya, lihat Proyek Office di lingkungan Visual Studio.

Pilih versi .NET Framework

Setelah memilih jenis proyek yang paling sesuai dengan kebutuhan Anda, Anda dapat memilih versi .NET Framework mana yang akan digunakan dalam proses pengembangan Anda. Anda bisa menargetkan versi .NET Framework berikut ini di proyek Office:

  • .NET Framework 4

  • Profil Klien .NET Framework 4

  • .NET Framework 4.5

    Versi .NET Framework yang Anda pilih untuk proyek Anda diperlukan di komputer pengguna akhir agar solusi Anda berjalan. Misalnya, jika proyek Anda menargetkan .NET Framework 4, .NET Framework 4 diperlukan pada komputer pengguna akhir. Dalam contoh ini, solusi Anda tidak akan berjalan jika hanya .NET Framework 3.5 yang diinstal pada komputer pengguna akhir.

    Jika Anda memigrasikan proyek Add-in VSTO yang menargetkan .NET Framework 3.5, Visual Studio mengubah kerangka kerja target proyek Anda ke .NET Framework 4 atau yang lebih baru tergantung pada versi Office yang telah Anda instal.

    Namun, setelah Visual Studio mengubah kerangka kerja target, Anda mungkin perlu memodifikasi beberapa kode dalam proyek Anda jika menggunakan fitur tertentu. Untuk informasi selengkapnya tentang cara mengubah kerangka kerja target, lihat Cara: Menargetkan versi .NET Framework. Untuk informasi selengkapnya tentang perubahan yang mungkin perlu Anda buat di proyek Anda, lihat Memigrasikan solusi Office ke .NET Framework 4 atau yang lebih baru.

    Jika Visual Studio mengubah target .NET Framework untuk proyek Anda dan Anda menggunakan ClickOnce untuk menyebarkan solusi Anda, pastikan Anda juga memilih versi .NET Framework yang sesuai dalam kotak dialog Prasyarat . Pilihan ini tidak berubah secara otomatis saat Anda mengubah kerangka kerja target untuk proyek Anda. Untuk informasi selengkapnya, lihat Cara: Menginstal prasyarat di komputer pengguna akhir untuk menjalankan solusi Office.

Catatan

Anda tidak dapat menargetkan .NET Framework 3.5 atau yang lebih lama di proyek Office yang Anda buat dengan menggunakan Visual Studio 2013. Proyek Office yang Anda buat dengan menggunakan Visual Studio 2013 memerlukan fitur yang pertama kali diperkenalkan di Profil Klien .NET Framework 4

Memahami kapan PIA Office diperlukan di komputer pengguna akhir

Secara default, rakitan interop utama Office (PIAs) tidak perlu diinstal pada komputer pengguna akhir jika properti Embed Interop Type dari setiap referensi Office PIA dalam proyek diatur ke True, yang merupakan nilai default. Dalam skenario ini, informasi jenis untuk jenis PIA yang digunakan oleh solusi Anda disematkan ke dalam rakitan solusi saat Anda membangun proyek. Pada waktu proses, informasi jenis yang disematkan digunakan alih-alih PIA untuk memanggil model objek berbasis COM aplikasi Office lication. Untuk informasi selengkapnya tentang bagaimana jenis dari PIA disematkan ke dalam solusi Anda, lihat Jenis kesetaraan dan jenis interop yang disematkan.

Jika properti Sematkan Tipe Interop dari setiap referensi PIA Office dalam proyek diatur ke False, PIA Office harus diinstal dan didaftarkan di cache perakitan global di setiap komputer pengguna akhir yang menjalankan solusi. Dalam kebanyakan kasus, PIA diinstal secara default dengan Office, tetapi Anda juga dapat menyertakan PIA yang dapat didistribusikan ulang sebagai prasyarat untuk solusi Anda. Untuk informasi selengkapnya, lihat Prasyarat solusi Office untuk penyebaran.

Memahami profil klien

Profil Klien .NET Framework adalah subset dari .NET Framework lengkap. Anda dapat menargetkan Profil Klien .NET Framework jika Anda hanya perlu menggunakan fitur klien di .NET Framework dan Anda ingin memberikan pengalaman penyebaran tercepat untuk solusi Office Anda. Untuk informasi selengkapnya, lihat profil klien .NET Framework.

Saat Anda membuat proyek Office yang menargetkan .NET Framework 4, Profil Klien .NET Framework 4 ditargetkan secara default. Jika Anda ingin mengembangkan untuk .NET Framework 4 lengkap, Anda harus mengatur opsi ini setelah proyek dibuat. Untuk informasi selengkapnya, lihat Cara: Menargetkan versi .NET Framework.

Membuat solusi untuk Microsoft Office edisi 64-bit

Microsoft Office tersedia dalam edisi 64-bit dan 32-bit. Untuk membuat solusi Office yang dapat berjalan di salah satu edisi, pengaturan target platform untuk proyek Anda harus diatur ke CPU apa pun. Ini adalah nilai default untuk proyek Office. Untuk informasi selengkapnya, lihat Membangun solusi Office.

Ada versi 64-bit dan 32-bit terpisah dari runtime Visual Studio Tools for Office yang digunakan oleh Microsoft Office edisi 64-bit dan 32-bit. Untuk informasi selengkapnya, lihat Gambaran umum runtime Visual Studio Tools for Office.

Rakitan di solusi Office

Saat Anda membuat proyek Office dengan menggunakan alat pengembangan Office di Visual Studio, kode yang Anda tulis akhirnya dikompilasi ke dalam rakitan. Rakitan disebarkan ke server bersama atau ke direktori di komputer klien.

Rakitan di solusi Office dimuat oleh aplikasi Office likasi. Setelah rakitan dimuat, kode di rakitan dapat merespons peristiwa yang dinaikkan dalam aplikasi, misalnya, saat pengguna mengklik item menu. Kode dalam rakitan juga dapat memanggil model objek untuk mengotomatiskan dan memperluas aplikasi, dan dapat menggunakan salah satu kelas di .NET Framework. Untuk informasi selengkapnya, lihat Arsitektur kustomisasi tingkat dokumen dan Arsitektur Add-in VSTO.

Solusi Office menggunakan manifes penyebaran dan manifes aplikasi untuk mengidentifikasi perakitan. Manifes berisi informasi tentang nama, versi, dan lokasi assembly, sehingga aplikasi dapat menemukan, menautkan ke, dan menjalankan assembly yang benar. Untuk informasi selengkapnya, lihat Manifes aplikasi dan penyebaran di solusi Office.

Proyek tingkat dokumen menyertakan dokumen selain rakitan. Dokumen bertindak sebagai ujung depan aplikasi dan merupakan tempat semua interaksi pengguna terjadi. Setiap dokumen hanya dapat memiliki satu rakitan proyek utama yang terkait dengannya; namun, beberapa dokumen dapat menunjuk ke rakitan yang sama.

Rakitan dalam proyek tingkat dokumen tidak disematkan dalam dokumen; sebaliknya, mereka disimpan di tempat lain dan diidentifikasi oleh manifes aplikasi dokumen.

Pertimbangan keamanan untuk rakitan

Agar solusi Office berjalan di komputer, rakitan yang digunakan oleh solusi harus dipercaya untuk dijalankan. Untuk informasi selengkapnya tentang keamanan, lihat Mengamankan solusi Office.

Secara default, rakitan solusi dan rakitan yang direferensikan yang ada di folder output proyek Anda dipercaya untuk dijalankan di komputer pengembangan saat Anda membangun proyek. Untuk informasi selengkapnya, lihat Membangun solusi Office.

Untuk alasan keamanan, yang terbaik adalah membuat proyek di komputer lokal Anda, daripada mengembangkan di lokasi bersama. Untuk informasi selengkapnya, lihat Pengembangan solusi Office yang kolaboratif.

Rakitan referensi

Rakitan dapat mereferensikan rakitan lain, yang tercantum dalam referensi proyek. Namun, satu rakitan proyek tingkat dokumen tidak dapat mereferensikan perakitan proyek tingkat dokumen lainnya.

Konten terkait