İzlenecek Yol: Proje için İlk Uygulama Düzeyi Eklentinizi Yaratma

Makale
08/01/2011

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 alanı: Bu konudaki bilgiler Project 2007 ve Project 2010 uygulamalarının uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Bu anlatım aşağıdaki görevleri gösterir:

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. Bu öğeleri bilgisayarınızdaki Visual Studio sürümü ve kullandığınız ayarlar belirler. Daha fazla bilgi için bkz: Visual Studio Ayarlar.

Önkoşullar

Bu anlatımı 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 2010 sürümü. Daha fazla bilgi için bkz: [Office Çözümeri Geliştirmek İçin Bilgisayarı Yapılandırma](bb398242\(v=vs.100\).md).

Microsoft Office Project 2007 veya Project 2010.

Projeyi Oluşturma

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

Visual Studio uygulamasını başlatın.
File (Dosya) menüsünde, New'un (Yeni) üzerine gelin ve Project'i (Proje) tıklatın.
Şablon bölmesinde Visual C# veya Visual Basic'i genişletin ve sonra Office'i genişletin.
Genişletilmiş Office düğümünde, bilgisayarınızda Project 2007 yüklü ise 2007'ı ya da Project 2010 yüklü ise 2010'i seçin.
Proje şablonları listesinde Project 2007 Eklentisi'ni ya da Project 2010 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 (BuEklenti) 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'e 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 Çözümleri Yapı İşlemine Genel Bakış.
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 temizleme

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:

Project 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 eklentileri derleme ve hataları ayıklama: Office Çözümlerini Oluşturma ve Hatalarını Ayıklama.
Project için uygulama düzeyi eklentileri dağıtma: Office Çözümlerini Dağıtma.