Bagikan melalui

Panduan: Membuat Add-in VSTO pertama Anda untuk Project

  • Artikel

Panduan ini memperlihatkan kepada Anda cara membuat Add-in VSTO untuk Microsoft Office Project. Fitur yang Anda buat dalam solusi semacam ini tersedia untuk aplikasi itu sendiri, terlepas dari proyek mana yang terbuka. Untuk informasi selengkapnya, lihat Gambaran umum pengembangan solusi Office (VSTO).

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek Add-in VSTO untuk Project. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Panduan ini mengilustrasikan tugas-tugas berikut:

  • Membuat proyek Add-in Project VSTO.

  • Menulis kode yang menggunakan model objek Project untuk menambahkan tugas ke proyek baru.

  • Membangun dan menjalankan proyek untuk mengujinya.

  • Membersihkan proyek yang telah selesai sehingga Add-in VSTO tidak lagi berjalan secara otomatis di komputer pengembangan Anda.

    Catatan

    Komputer Anda mungkin memperlihatkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam petunjuk berikut. Edisi Visual Studio yang Anda miliki dan setelan yang Anda gunakan menentukan elemen-elemen ini. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

Membuat proyek

Untuk membuat proyek baru di Visual Studio

  1. Mulai Visual Studio.

  2. Pada menu File, arahkan ke Baru, lalu klik Proyek.

  3. Di panel templat, perluas Visual C# atau Visual Basic, lalu perluas Office/SharePoint.

  4. Di bawah simpul Office/SharePoint yang diperluas, pilih simpul Add-in Office.

  5. Dalam daftar templat proyek, pilih Add-in Project 2010 atau Add-in Project 2013.

  6. Dalam kotak Nama , ketik FirstProjectAddIn.

  7. Klik OK.

    Visual Studio membuat proyek FirstProjectAddIn dan membuka file kode ThisAddIn di editor.

Menulis kode yang menambahkan tugas baru ke proyek

Selanjutnya, tambahkan kode ke file kode ThisAddIn. Kode baru menggunakan model objek Project untuk menambahkan tugas baru ke proyek. Secara default, file kode ThisAddIn berisi kode yang dihasilkan berikut:

  • Definisi parsial kelas ThisAddIn . Kelas ini menyediakan titik masuk untuk kode Anda dan menyediakan akses ke model objek Project. Untuk informasi selengkapnya, lihat Add-in VsTO Program. ThisAddIn Sisa kelas ditentukan dalam file kode tersembunyi yang tidak boleh Anda ubah.

  • Penanganan ThisAddIn_Startup aktivitas dan ThisAddIn_Shutdown . Penanganan aktivitas ini dipanggil saat Project memuat dan membongkar Add-in VSTO Anda. Gunakan penanganan aktivitas ini untuk menginisialisasi Add-in VSTO Anda saat dimuat, dan untuk membersihkan sumber daya yang digunakan oleh Add-in VSTO Anda saat dibongkar. Untuk informasi selengkapnya, lihat Peristiwa di proyek Office.

Untuk menambahkan tugas ke proyek baru

  1. Dalam file kode ThisAddIn, tambahkan kode berikut ke ThisAddIn kelas . Kode ini mendefinisikan penanganan aktivitas untuk NewProject peristiwa Microsoft.Office.Interop.MSProject.Application kelas.

    Saat pengguna membuat proyek baru, penanganan aktivitas ini menambahkan tugas ke proyek.

    void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
{
    MSProject.Task newTask = pj.Tasks.Add
        ("This text was added by using code", missing);
    newTask.Start = DateTime.Now;
    newTask.Duration = "3";
    newTask.ResourceNames = "Rob Caron, Kelly Krout";
}

    Untuk mengubah proyek, contoh kode ini menggunakan objek berikut:

  • Bidang ApplicationThisAddIn kelas. Bidang Application mengembalikan Microsoft.Office.Interop.MSProject.Application objek, yang mewakili instans Project saat ini.

  • Parameter pj penanganan aktivitas untuk peristiwa NewProject. Parameter pj adalah Microsoft.Office.Interop.MSProject.Project objek, yang mewakili proyek. Untuk informasi selengkapnya, lihat Solusi proyek.

  1. Jika Anda menggunakan C#, tambahkan kode berikut ke penanganan ThisAddIn_Startup aktivitas. Kode ini menghubungkan Application_Newproject penanganan aktivitas dengan peristiwa NewProject.

    this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);

Menguji proyek

Saat Anda membuat dan menjalankan proyek, verifikasi bahwa tugas baru muncul dalam proyek baru yang dihasilkan.

Untuk menguji proyek

  1. Tekan F5 untuk membangun dan menjalankan proyek Anda. Microsoft Project memulai dan secara otomatis membuka proyek kosong baru.

    Saat Anda membangun proyek, kode dikompilasi ke dalam rakitan yang disertakan dalam folder output build untuk proyek. Visual Studio juga membuat sekumpulan entri registri yang memungkinkan Project menemukan dan memuat Add-in VSTO, dan mengonfigurasi pengaturan keamanan pada komputer pengembangan untuk mengaktifkan Add-in VSTO untuk dijalankan. Untuk informasi selengkapnya, lihat Gambaran umum proses build solusi Office.

  2. Verifikasi bahwa tugas baru ditambahkan ke proyek kosong.

  3. Verifikasi bahwa teks berikut muncul di bidang Nama Tugas tugas.

    Teks ini ditambahkan dengan menggunakan kode.

  4. Tutup Microsoft Project.

Membersihkan proyek

Setelah Anda selesai mengembangkan proyek, hapus rakitan Add-in VSTO, entri registri, dan pengaturan keamanan dari komputer pengembangan Anda. Jika tidak, Add-in VSTO akan berjalan setiap kali Anda membuka Microsoft Project di komputer pengembangan.

Untuk membersihkan proyek Anda

  1. Di Visual Studio, pada menu Build , klik Bersihkan Solusi.

Langkah berikutnya

Sekarang setelah Anda membuat Add-in VSTO dasar untuk Project, Anda dapat mempelajari lebih lanjut tentang cara mengembangkan Add-in VSTO dari topik-topik ini:

  • Tugas pemrograman umum yang dapat Anda lakukan di Add-in VSTO untuk Project: Add-in VsTO Program.

  • Menggunakan model objek Project: Solusi proyek.

  • Membangun dan men-debug Add-in VSTO untuk Project: Membangun solusi Office.

  • Menyebarkan Add-in VSTO untuk Project: Menyebarkan solusi Office.

Konten terkait