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

Bu anlatımda Microsoft Office Outlook için uygulama düzeyi eklentilerin nasıl oluşturulduğu gösterilir.Bu tarz çözümde oluşturduğunuz özellikler hangi Outlook öğesinin 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, Outlook 2013 ve Outlook 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:

• Outlook için bir Outlook eklenti projesi oluşturma.

• Yeni bir posta iletisinin konusuna ya da gövdesine metin eklemek için Outlook 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.

• Outlook 2013 veya Outlook 2010.

Projeyi Oluşturma

Visual Studio'da Yeni Outlook Projesi Yaratma

1. Visual Studio uygulamasını başlatın.

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

3. Şablonlar bölmesinde genişletin Visual C# veya Visual Basicve sonra genişletin Office/SharePoint.

4. Genişletilmiş altında Office/SharePoint düğümü, select Office eklentileri düğümü.

5. Proje şablonları listesinde Outlook 2010 Eklentisi'ni ya da Outlook 2013 Eklentisi'ni seçin.

6. Ad kutusuna FirstOutlookAddIn (BirinciOutlookEklentisi) yazın.

7. Tamam düğmesini tıklatın.

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

Her Yeni Posta İletisine Metin Ekleyen Kod Yazma

Sonra, kodu ThisAddIn kod dosyasına ekleyin.Yeni kod, her yeni posta iletisine metin eklemek için Outlook 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 Outlook'un 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, Outlook 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.

Her yeni posta iletisinin konu ve gövdesine metin ekleme

1. ThisAddIn kod dosyasında, ThisAddIn sınıfında inspectors adında bir alan bildirin.inspectors alanı geçerli Outlook örneğinde Inspector penceresi koleksiyonuna bir başvuru içerir.Bu başvuru, atık toplayıcının NewInspector olayı işleyicisini içeren belleği boşaltmasını engeller.

   Private WithEvents inspectors As Outlook.Inspectors
   

   Outlook.Inspectors inspectors;
   

2. ThisAddIn_Startup yöntemini aşağıdaki kod ile değiştirin.Bu kod NewInspector olayına bir olay işleyicisi ekler.

   Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       inspectors = Me.Application.Inspectors
   End Sub
   

   private void ThisAddIn_Startup(object sender, System.EventArgs e)
   {
       inspectors = this.Application.Inspectors;
       inspectors.NewInspector +=
       new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
   }
   

3. ThisAddIn kod dosyasında aşağıdaki kodu ThisAddIn sınıfına ekleyin.Bu kod NewInspector olayı için bir olay işleyicisi tanımlar.

   Kullanıcı yeni bir posta iletisini oluşturduğunda, bu olay işleyicisi konu satırına ve iletinin gövdesine metin ekler.

   Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
       Dim mailItem As Outlook.MailItem = TryCast(Inspector.CurrentItem, Outlook.MailItem)
       If Not (mailItem Is Nothing) Then 
           If mailItem.EntryID Is Nothing Then
               mailItem.Subject = "This text was added by using code"
               mailItem.Body = "This text was added by using code" 
           End If 
       End If 
   End Sub
   

   void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
   {
       Outlook.MailItem mailItem = Inspector.CurrentItem as Outlook.MailItem;
       if (mailItem != null)
       {
           if (mailItem.EntryID == null)
           {
               mailItem.Subject = "This text was added by using code";
               mailItem.Body = "This text was added by using code";
           }
   
       }
   }
   

Her yeni posta iletisini değiştirmek için yukarıdaki kod örnekleri aşağıdaki nesneleri kullanır:

• ThisAddIn sınıfının Application alanı.Application alanı, Outlook'un geçerli örneğini gösteren Application nesnesini döndürür.

• NewInspector olayı işleyicisinin Inspector parametresi.Inspector parametresi, yeni posta iletisinin Inspector penceresini gösteren bir Inspector nesnesidir.Daha fazla bilgi için bkz. Outlook Çözümleri.

Projeyi Test Etme

Projeyi derleyip çalıştırdığınız zaman yeni posta iletisinin konu satırında ve gövdesinde metnin geçtiğini doğrulayın.

Projeyi test etmek için

1. Projeyi derlemek ve çalıştırmak için F5'a basın.

   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 Outlook'un 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. İzlenecek Yol: Outlook için İlk Uygulama Düzeyi Eklentiyi Oluşturma.

2. Outlook'ta yeni bir posta iletisi oluşturun.

3. Yeni posta iletisinin konu satırına ve gövdesine aşağıdaki metnin eklendiğini doğrulayın.

   Bu metin kod kullanılarak eklenmiştir.

4. Outlook'u 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, Outlook'u 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

Outlook 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:

• Outlook için eklentiler kullanarak gerçekleştirebileceğiniz genel programlama görevleri:Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentileri Programlama.

• Outlook nesne modelini kullanma:Daha fazla bilgi için bkz. Outlook Çözümleri.

• Outlook KA'sını özelleştirme, örneğin Şerit'e özel bir sekme ekleme veya kendi özel görev bölmenizi oluşturma:Daha fazla bilgi için bkz. Office Kullanıcı Arabirimini Özelleştirme.

• Outlook için uygulama düzeyi eklentileri derleme ve hataları ayıklama:Daha fazla bilgi için bkz. Office Çözümleri Oluşturma.

• Outlook için uygulama düzeyi eklentileri dağıtma:Daha fazla bilgi için bkz. Office Çözümünü Dağıtma.

Ayrıca bkz.

Diğer Kaynaklar

Uygulama Düzeyi Eklentileri Programlama

Outlook Çözümleri

Office Kullanıcı Arabirimini Özelleştirme

Office Çözümleri Oluşturma

Office Çözümünü Dağıtma

Office Proje Şablonlarına Genel Bakış