Gambaran umum runtime Visual Studio Tools for Office

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 ini adalah rakitan terkelola yang menyediakan lapisan komunikasi antara solusi Anda dan aplikasi Microsoft Office. Untuk informasi selengkapnya, lihat Memahami ekstensi Office untuk .NET Framework.

  • Pemuat solusi Office. Komponen ini adalah sekumpulan DLL tidak terkelola yang digunakan aplikasi Office 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 skenario penginstalan runtime Visual Studio Tools untuk 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. 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 pada Kerangka Kerja .NET 4 atau yang lebih baru, jenis Worksheet dan jenis 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 tipe dan tipe 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 memiliki versi yang independen satu sama lain. 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 melakukan perubahan ini, informasi tipe untuk semua jenis runtime yang digunakan oleh proyek akan disematkan ke dalam assembly solusi saat proyek dibangun. 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 mencakup beberapa DLL yang tidak dikelola yang digunakan aplikasi Office 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 memanggil VSTOEE.dll untuk melakukan tugas yang diperlukan untuk memuat Visual Studio Tools for Office runtime.

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 dari runtime yang terpasang di 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. IDTExtensibility2 adalah antarmuka COM yang harus diterapkan semua Add-in VSTO untuk aplikasi Microsoft Office. Antarmuka ini mendefinisikan metode yang dipanggil aplikasi untuk berkomunikasi dengan Add-in VSTO.

  • Ini mengimplementasikan antarmuka IManagedAddin. Antarmuka ini digunakan oleh aplikasi Office 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 for Office runtime dengan Office, lihat skenario penginstalan Visual Studio Tools for Office runtime.

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

  • Last updated on