Bagikan melalui

Gambaran umum runtime Visual Studio Tools for Office

  • Artikel

Untuk menjalankan solusi yang dibuat dengan menggunakan alat pengembang Microsoft Office di Visual Studio, runtime Visual Studio 2010 Tools for Office harus diinstal di komputer pengguna akhir. Untuk informasi selengkapnya, lihat Cara: Menginstal Alat Visual Studio untuk runtime Office yang dapat didistribusikan ulang. Runtime Visual Studio 2010 Tools for Office terdiri dari dua komponen utama:

  • Ekstensi Office untuk .NET Framework. Komponen-komponen ini adalah rakitan terkelola yang menyediakan lapisan komunikasi antara solusi Anda dan Microsoft aplikasi Office lication. Untuk informasi selengkapnya, lihat Memahami ekstensi Office untuk .NET Framework.

  • Pemuat solusi Office. Komponen ini adalah sekumpulan DLL tidak terkelola yang aplikasi Office likasi gunakan untuk memuat runtime dan solusi Anda. Untuk informasi selengkapnya, lihat Memahami pemuat solusi Office.

    Runtime dapat diinstal dengan beberapa cara yang berbeda. Bergantung pada konfigurasi komputer, komponen runtime yang berbeda diinstal saat Anda menginstal runtime. Untuk informasi selengkapnya, lihat Visual Studio Tools untuk skenario penginstalan runtime Office.

Memahami ekstensi Office untuk .NET Framework

Runtime Visual Studio 2010 Tools for Office menyertakan ekstensi Office untuk .NET Framework 3.5, .NET Framework 4 dan yang lebih baru. Solusi yang menargetkan setiap versi .NET Framework menggunakan ekstensi yang sesuai untuk versi tersebut.

Ekstensi ini terdiri dari rakitan yang digunakan solusi Anda untuk mengotomatiskan dan memperluas aplikasi Office likasi. Saat Anda membuat proyek Office, Visual Studio secara otomatis menambahkan referensi ke rakitan yang digunakan untuk jenis proyek dan target .NET Framework proyek. Untuk informasi selengkapnya tentang rakitan di ekstensi Office, lihat Rakitan di runtime Visual Studio Tools for Office.

Perbedaan desain dalam ekstensi Office

Sebagian besar jenis yang Anda gunakan di ekstensi Office untuk .NET Framework 3.5 adalah kelas. Ini adalah kelas yang sama yang disertakan dalam versi Visual Studio Tools for Office runtime sebelumnya. Sebaliknya, sebagian besar jenis yang Anda gunakan di ekstensi Office untuk .NET Framework 4 atau yang lebih baru adalah antarmuka. Misalnya, ketika Anda menargetkan .NET Framework 4 atau yang lebih baru, Worksheet jenis dan Document adalah antarmuka, bukan kelas.

Dalam kebanyakan kasus, kode yang Anda tulis di solusi Office sama apakah solusi Anda menargetkan .NET Framework 3.5 atau .NET Framework 4. Namun, fitur tertentu memerlukan kode yang berbeda ketika Anda menargetkan versi .NET Framework yang berbeda. Untuk informasi selengkapnya, lihat Memigrasikan solusi Office ke .NET Framework 4 atau yang lebih baru.

Antarmuka dalam ekstensi Office untuk .NET Framework 4 atau yang lebih baru

Sebagian besar antarmuka dalam ekstensi Office untuk .NET Framework 4 atau yang lebih baru tidak dimaksudkan untuk diimplementasikan oleh kode pengguna. Satu-satunya antarmuka yang dapat Anda terapkan secara langsung memiliki nama yang dimulai dengan huruf I, seperti ISmartTagExtension.

Semua antarmuka yang tidak dimulai dengan huruf saya diimplementasikan secara internal oleh runtime Visual Studio 2010 Tools for Office, dan antarmuka ini mungkin berubah dalam rilis mendatang. Untuk membuat objek yang mengimplementasikan antarmuka ini, gunakan metode yang disediakan oleh Globals.Factory objek dalam proyek Anda. Misalnya, untuk mendapatkan objek yang mengimplementasikan SmartTag antarmuka, gunakan Globals.Factory.CreateSmartTag metode . Untuk informasi selengkapnya tentang Globals.Factory, lihat Akses global ke objek di proyek Office.

Mengaktifkan kesetaraan jenis dan jenis yang disematkan dalam proyek yang menargetkan .NET Framework 4 atau yang lebih baru

Karena model objek ekstensi Office untuk .NET Framework 4 atau yang lebih baru didasarkan pada antarmuka, Anda dapat menggunakan fitur kesetaraan jenis di Visual C# dan Visual Basic di Visual Studio untuk menyematkan informasi jenis dari Runtime Visual Studio Tools for Office ke dalam solusi Anda. Fitur ini memungkinkan solusi Office dan runtime Visual Studio Tools for Office untuk saling membuat versi secara independen. Misalnya, jika solusi Anda menggunakan Document antarmuka sebagai jenis yang disematkan dan versi runtime berikutnya menambahkan anggota ke Document antarmuka, solusi Anda masih akan berfungsi dengan versi runtime berikutnya. Jika solusi Anda tidak menggunakan Document antarmuka sebagai jenis yang disematkan, maka solusi Anda tidak akan lagi berfungsi dengan versi runtime berikutnya.

Secara default, fitur kesetaraan jenis tidak diaktifkan saat Anda membuat proyek Office yang menargetkan .NET Framework 4 atau yang lebih baru. Jika Anda ingin mengaktifkan fitur ini, atur properti Embed Interop Type dari salah satu referensi rakitan berikut dalam proyek Anda ke True:

  • Microsoft.Office.Tools.dll

  • Microsoft.Office.Tools.Common.dll

  • Microsoft.Office.Tools.Excel.dll

  • Microsoft.Office.Tools.Outlook.dll

  • Microsoft.Office.Tools.Word.dll

    Setelah Anda membuat perubahan ini, ketik informasi untuk semua jenis runtime yang digunakan oleh proyek disematkan ke dalam rakitan solusi saat Anda membangun proyek. Informasi jenis yang disematkan ini, daripada informasi jenis dalam rakitan yang direferensikan, digunakan oleh solusi pada waktu proses.

Memahami pemuat solusi Office

Runtime Visual Studio Tools for Office menyertakan beberapa DLL tidak terkelola yang aplikasi Office likasi gunakan untuk memuat runtime dan solusi Office. Meskipun Anda seharusnya tidak perlu bekerja dengan DLL ini secara langsung, mengetahui tujuan DLL ini dapat membantu Anda lebih memahami arsitektur solusi Office.

Untuk informasi tentang bagaimana komponen ini digunakan selama proses pemuatan, lihat Arsitektur kustomisasi tingkat dokumen dan Arsitektur Add-in VSTO.

VSTOEE.dll

Saat pengguna membuka kustomisasi tingkat dokumen atau memulai Add-in VSTO, aplikasi Office likasi memanggil vstoee.dll untuk melakukan tugas yang diperlukan untuk memuat Alat Visual Studio untuk runtime Office.

VSTOEE.dll memastikan bahwa versi runtime Visual Studio Tools for Office yang benar dimuat untuk solusi dan versi Office yang diinstal. Meskipun beberapa versi runtime Visual Studio Tools for Office dapat diinstal pada komputer yang sama, hanya satu instans VSTOEE.dll yang diinstal pada satu waktu. Ini adalah VSTOEE.dll yang disertakan dengan versi terbaru runtime yang diinstal pada komputer. Untuk informasi selengkapnya tentang berbagai versi runtime Visual Studio Tools for Office yang dapat digunakan untuk solusi lain, lihat Menjalankan solusi dalam versi Microsoft Office yang berbeda.

VSTOLoader.dll

Setelah VSTOEE.dll memuat versi runtime Visual Studio Tools for Office yang sesuai, VSTOLoader.dll melakukan sebagian besar pekerjaan yang diperlukan untuk memuat rakitan solusi. VSTOLoader.dll melakukan beberapa hal:

  • Ini membuat domain aplikasi untuk setiap rakitan solusi.

  • Ini melakukan serangkaian pemeriksaan keamanan untuk memverifikasi bahwa rakitan solusi memiliki izin untuk dijalankan.

  • Ini memuat versi ekstensi Office untuk .NET Framework yang diperlukan oleh solusi.

    VSTOLoader.dll juga melakukan beberapa hal yang khusus untuk Add-in VSTO:

  • Ini mengimplementasikan IDTExtensibility2 antarmuka. IDTExtensibility2adalah antarmuka COM yang harus diterapkan oleh semua Add-in VSTO untuk Microsoft aplikasi Office lications. Antarmuka ini mendefinisikan metode yang dipanggil aplikasi untuk berkomunikasi dengan Add-in VSTO.

  • Ini mengimplementasikan antarmuka IManagedAddin. Antarmuka ini digunakan oleh aplikasi Office likasi untuk membantu memuat Add-in VSTO. Untuk informasi selengkapnya, lihat Antarmuka IManagedAddin.

Memahami versi runtime 32-bit dan 64-bit

Ada versi 64-bit dan 32-bit terpisah dari Runtime Visual Studio 2010 Tools for Office. Versi runtime ini digunakan untuk menjalankan solusi dalam Office edisi 64-bit dan 32-bit. Tabel berikut ini memperlihatkan versi runtime mana yang diperlukan untuk setiap kombinasi Windows dan Office.

Edisi Windows Edisi Microsoft Office Versi yang diperlukan dari Visual Studio Tools untuk runtime Office
32-bit 32-bit 32-bit
64-bit 32-bit 64-bit
64-bit 64-bit 64-bit

Saat Anda menginstal Office, versi runtime Visual Studio Tools for Office yang diperlukan diinstal bersama dengan Office. Misalnya, saat Anda menginstal Office edisi 64-bit pada Windows versi 64-bit, versi 64-bit runtime Visual Studio Tools for Office juga diinstal. Untuk informasi selengkapnya tentang menginstal Visual Studio Tools untuk runtime Office dengan Office, lihat Visual Studio Tools untuk skenario penginstalan runtime Office.

Office versi 64-bit juga dapat menjalankan solusi Office yang dibuat dengan menggunakan templat proyek untuk sistem Microsoft Office 2007 di Visual Studio 2008. Namun, ini tidak dapat menjalankan solusi Office yang dibuat dengan menggunakan templat proyek untuk Microsoft Office 2003 di Visual Studio 2008, atau solusi Office yang dibuat dengan menggunakan Visual Studio 2005. Untuk informasi selengkapnya, lihat Menjalankan solusi dalam versi Microsoft Office yang berbeda.

Memperbaiki Alat Visual Studio 2010 untuk runtime Office

Jika Anda perlu memperbaiki runtime, buka Program dan Fitur atau Tambahkan atau Hapus Program di Panel Kontrol, pilih Alat Microsoft Visual Studio 2010 untuk Office Runtime dalam daftar program, lalu klik Hapus instalan. Program penyetelan yang berjalan memungkinkan Anda memperbaiki runtime. Jika Anda mengklik Ubah, Anda tidak diberi opsi untuk memperbaiki runtime.

Konten terkait