İzlenecek yol: Project için ilk VSTO Eklentinizi oluşturma

  • Makale

Bu kılavuzda, Microsoft Office Project için VSTO Eklentisi'nin nasıl oluşturulacağı gösterilmektedir. Bu tür bir çözümde oluşturduğunuz özellikler, hangi projelerin açık olduğuna bakılmaksızın uygulamanın kendisi tarafından kullanılabilir. Daha fazla bilgi için bkz . Office çözümleri geliştirmeye genel bakış (VSTO).

Şunlar için geçerlidir: Bu konudaki bilgiler Project için VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Bu izlenecek yol aşağıdaki görevleri gösterir:

  • Proje VSTO Eklentisi projesi oluşturma.

  • Yeni bir projeye görev eklemek için Project'in nesne modelini kullanan kod yazma.

  • Test etmek için projeyi oluşturma ve çalıştırma.

  • VsTO Eklentisinin artık geliştirme bilgisayarınızda otomatik olarak çalışmaması için tamamlanmış projeyi temizleme.

    Not

    Bilgisayarınız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazıları için farklı adlar veya konumlar gösterebilir. Sahip olduğunuz Visual Studio sürümü ve kullandığınız ayarlar bu öğeleri belirler. Daha fazla bilgi için bkz . IDE'yi kişiselleştirme.

Önkoşullar

Bu izlenecek yolu tamamlamak için aşağıdaki bileşenlere ihtiyacınız vardır:

  • Microsoft Office geliştirici araçlarını içeren bir Visual Studio sürümü. Daha fazla bilgi için bkz . Office çözümleri geliştirmek için bilgisayar yapılandırma.

  • Project 2013 veya Project 2010.

Proje oluşturma

Visual Studio'da yeni proje oluşturmak için

  1. Visual Studio’yu çalıştırın.

  2. Dosya menüsünde Yeni'nin üzerine gelin ve Proje'ye tıklayın.

  3. Şablonlar bölmesinde Visual C# veya Visual Basic'i ve ardından Office/SharePoint'i genişletin.

  4. Genişletilmiş Office/SharePoint düğümü altında Office Eklentileri düğümünü seçin.

  5. Proje şablonları listesinde Project 2010 Eklentisi veya Project 2013 Eklentisi'ni seçin.

  6. Ad kutusuna FirstProjectAddIn yazın.

  7. Tamam'a tıklayın.

    Visual Studio FirstProjectAddIn projesini oluşturur ve ThisAddIn kod dosyasını düzenleyicide açar.

Projeye yeni görev ekleyen kod yazma

Ardından ThisAddIn kod dosyasına kod ekleyin. Yeni kod, projeye yeni bir görev eklemek için Project'in nesne modelini kullanır. ThisAddIn kod dosyası varsayılan olarak aşağıdaki oluşturulan kodu içerir:

  • Sınıfın ThisAddIn kısmi tanımı. Bu sınıf kodunuz için bir giriş noktası sağlar ve Project'in nesne modeline erişim sağlar. Daha fazla bilgi için bkz . PROGRAM VSTO Eklentileri. Sınıfın ThisAddIn geri kalanı, değiştirmemeniz gereken gizli bir kod dosyasında tanımlanır.

  • ThisAddIn_Startup ve ThisAddIn_Shutdown olay işleyicileri. Project VSTO Eklentinizi yükleyip kaldırdığında bu olay işleyicileri çağrılır. Yüklendiğinde VSTO Eklentinizi başlatmak ve kaldırıldığında VSTO Eklentiniz tarafından kullanılan kaynakları temizlemek için bu olay işleyicilerini kullanın. Daha fazla bilgi için bkz . Office projelerindeki olaylar.

Yeni projeye görev eklemek için

  1. ThisAddIn kod dosyasında sınıfına ThisAddIn aşağıdaki kodu ekleyin. Bu kod, sınıfının olayı için NewProject bir olay işleyicisi Microsoft.Office.Interop.MSProject.Application tanımlar.

    Kullanıcı yeni bir proje oluşturduğunda, bu olay işleyicisi projeye bir görev ekler.

    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";
}

    Bu kod örneği, projeyi değiştirmek için aşağıdaki nesneleri kullanır:

  • Application Sınıfının alanıThisAddIn. alanı, Project'in Application geçerli örneğini temsil eden bir Microsoft.Office.Interop.MSProject.Application nesne döndürür.

  • pj NewProject olayı için olay işleyicisinin parametresi. pj parametresi, projeyi temsil eden bir Microsoft.Office.Interop.MSProject.Project nesnedir. Daha fazla bilgi için bkz . Proje çözümleri.

  1. C# kullanıyorsanız olay işleyicisine ThisAddIn_Startup aşağıdaki kodu ekleyin. Bu kod, olay işleyicisini Application_Newproject NewProject olayına bağlar.

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

Projeyi test etme

Projeyi derleyip çalıştırdığınızda, yeni görevin ortaya çıkan yeni projede göründüğünü doğrulayın.

Projeyi test etmek için

  1. Projenizi oluşturmak ve çalıştırmak için F5 tuşuna basın. Microsoft Project başlatılır ve otomatik olarak yeni bir boş proje açılır.

    Projeyi oluşturduğunuzda kod, projenin derleme çıktı klasörüne dahil edilen bir derlemede derlenmiştir. Visual Studio ayrıca Project'in VSTO Eklentisini bulup yüklemesini sağlayan bir kayıt defteri girdileri kümesi oluşturur ve VSTO Eklentisi'nin çalışmasını sağlamak için geliştirme bilgisayarındaki güvenlik ayarlarını yapılandırmaktadır. Daha fazla bilgi için bkz . Office çözümü derleme işlemine genel bakış.

  2. Boş projeye yeni bir görev eklendiğini doğrulayın.

  3. Aşağıdaki metnin görevin Görev Adı alanında göründüğünü doğrulayın.

    Bu metin kod kullanılarak eklendi.

  4. Microsoft Project'i kapatın.

Projeyi temizleme

Proje geliştirmeyi bitirdiğinizde VSTO Eklenti derlemesini, kayıt defteri girdilerini ve güvenlik ayarlarını geliştirme bilgisayarınızdan kaldırın. Aksi takdirde, geliştirme bilgisayarında Microsoft Project'i her açtığınızda VSTO Eklentisi çalışır.

Projenizi temizlemek için

  1. Visual Studio'da, Oluştur menüsünde Çözümü Temizle'ye tıklayın.

Sonraki adımlar

Project için temel bir VSTO Eklentisi oluşturduğunuza göre, şu konulardan VSTO Eklentileri geliştirme hakkında daha fazla bilgi edinebilirsiniz:

İlgili içerik