İzlenecek Yol: Proje için İlk Uygulama Düzeyi Eklentiyi Oluşturma

Makale
06/10/2015

Bu anlatımda Microsoft Office Project için uygulama düzeyi eklentilerinin nasıl oluşturulduğu gösterilir.Bu tarz çözümde oluşturduğunuz özellikler hangi projenin açık olduğuna bağlı olmaksızın uygulamanın kendisinde kullanılabilir.Daha fazla bilgi için bkz. Office Çözümleri Geliştirmesine Genel Bakış.

Uygulama hedefi: Bu konudaki bilgiler, Project 2013 ve Project 2010 için uygulama düzeyi projelere yöneliktir. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.

Bu örneklerde aşağıdaki görevler gösterilir:

Bir Project eklenti projesi oluşturma.
Yeni projeye bir görev eklemek için Project nesne modelini kullanan kod yazma.
Test etmek için projeyi oluşturma ve çalıştırma.
Geliştirici bilgisayarınızdaki tamamlanmış projeyi eklentinin artık otomatik olarak çalışmaması için 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. Visual Studio'da Geliştirme Ayarlarını özelleştirme.

Önkoşullar

Bu örneği tamamlamak için aşağıdaki bileşenler gerekmektedir:

Microsoft Office geliştirici araçlarını içeren bir Visual Studio 2013 sürümü. Daha fazla bilgi edinmek için, bkz. Office Çözümleri Geliştirmek İçin Bilgisayarı Yapılandırma.
Project 2013 veya Project 2010.

Projeyi Oluşturma

Visual Studio’da yeni bir proje oluşturmak için

Visual Studio uygulamasını başlatın.
Dosya menüsünde, Yeni'nin üzerine gelin ve Proje'ye tıklatın.
Şablonlar bölmesinde genişletin Visual C# veya Visual Basicve sonra genişletin Office/SharePoint.
Genişletilmiş altında Office/SharePoint düğümü, select Office eklentileri düğümü.
Proje şablonları listesinde Project 2010 Eklentisi'ni ya da Project 2013 Eklentisi'ni seçin.
Ad kutusuna FirstProjectAddIn yazın.
Tamam düğmesini tıklatın.

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

Projeye Yeni Görev Ekleyen Kod Yazma

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

ThisAddIn sınıfının kısmi tanımlaması.Bu sınıf kodunuz için bir giriş noktası sunar ve Project nesne modeline erişim sağlar.Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentileri Programlama.ThisAddIn sınıfının geri kalanı değiştirmemeniz gereken gizli bir kod dosyasında tanımlanmıştır.
ThisAddIn_Startup ve ThisAddIn_Shutdown olay işleyicileri.Bu olay işleyicileri, Project sizin eklentinizi yüklediğinde ve kaldırdığında çağırılır.Eklentiniz yüklendiğinde eklentinizi başlatmak ve kaldırıldığında eklentinizin kullandığı 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

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

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

Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject
    Dim newTask As MSProject.Task
    newTask = pj.Tasks.Add _
    ("This text was added by using code")
    newTask.Start = DateTime.Now
    newTask.Duration = "3"
    newTask.ResourceNames = "Rob Caron, Kelly Krout" 
End Sub

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

Projeyi değiştirmek için bu örnek kod aşağıdaki nesneleri kullanır:

ThisAddIn sınıfının Application alanı.Application alanı, Project'in geçerli örneğini gösteren Microsoft.Office.Interop.MSProject.Application nesnesini döndürür.
NewProject olayı işleyicisinin pj parametresi.pj parametresi, projeyi temsil eden Microsoft.Office.Interop.MSProject.Project nesnesidir.Daha fazla bilgi için bkz. Proje Çözümleri.

C# kullanıyorsanız, ThisAddIn_Startup olay işleyicisine aşağıdaki kodu ekleyin.Bu kod Application_Newproject olay işleyicisini NewProject olayı ile 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 sonuçlanan yeni projede göründüğünü doğrulayın.

Projeyi test etmek için

Projeyi derlemek ve çalıştırmak için F5'a basın.Microsoft Project başlar ve yeni boş bir proje açar.

Projeyi derlediğinizde kod, projenin yapı çıktı klasörüne dahil edilen bir bütünleştirilmiş koda dönüşür.Visual Studio ayrıca Project'in eklentiyi fark edip yükleyebilmesi için kayıt girdilerinden oluşan bir küme yaratır ve eklentinin çalışabilmesi için geliştirici bilgisayarının güvenlik ayarlarını yapılandırır.Daha fazla bilgi için bkz. Office Solution Build Process Overview.
Boş projeye yeni bir görevin eklendiğini doğrulayın.
Aşağıdaki metnin, görevin Task Name (Görev İsmi) alanında göründüğünü doğrulayın.

Bu metin kod kullanılarak eklenmiştir.
Microsoft Project'i kapatın.

Projeyi Temizleme

Projeyi geliştirmeyi bitirdiğinizde eklentinin bütünleştirilmiş kodunu, kayıt girdilerini ve güvenlik ayarlarını geliştirme bilgisayarınızdan kaldırın.Aksi halde, Microsoft Project'i geliştirme bilgisayarında her açtığınızda eklenti çalışacaktır.

Projenizi temizlemek için

Visual Studio Build (Yapı) menüsünde Clean Solution'a (Çözümü Temizle) tıklayın.

Sonraki Adımlar

Project için temel bir uygulama düzeyi eklentisi oluşturduğunuza göre, eklentileri nasıl geliştireceğiniz hakkında daha fazlasını bu konulardan öğrenebilirsiniz:

Proje için eklentiler kullanarak gerçekleştirebileceğiniz genel programlama görevleri: Uygulama Düzeyi Eklentileri Programlama.
Project nesne modelini kullanma: Proje Çözümleri.
Project için uygulama düzeyi eklentilerde hata ayıklama ve oluşturma: Office Çözümleri Oluşturma.
Project için uygulama düzeyi eklentileri dağıtma: Office Çözümünü Dağıtma.