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

Makale
08/01/2011

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 alanı: Bu konudaki bilgiler Outlook 2007 ve Outlook 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:

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.
Sınamak 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 Outlook 2007 veya Outlook 2010.

Projeyi Oluşturma

Visual Studio'da Yeni Outlook Projesi Yaratma

Visual Studio uygulamasını başlatın.
Dosya menüsünde, Yeni'nin üzerine gelin ve Proje'yi 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 Outlook 2007 yüklü ise 2007'yi ya da Outlook 2010 yüklü ise 2010'u seçin.
Proje şablonları listesinde Outlook 2007 Eklentisi'ni ya da Outlook 2010 Eklentisi'ni seçin.
Ad kutusuna FirstOutlookAddIn (BirinciOutlookEklentisi) yazın.
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 (BuEklenti) 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

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;
```

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

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 = CType(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 = (Outlook.MailItem)Inspector.CurrentItem;
    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 Sınama

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 sınama

Projeyi derlemek ve çalıştırmak için F5'e 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. Office Çözümleri Yapı İşlemine Genel Bakış.
Outlook'ta yeni bir posta iletisi oluşturun.
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.
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 temizleme

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 UI Özelleştirmesi.
Outlook için uygulama düzeyi eklentileri derleme ve hataları ayıklama: Daha fazla bilgi için bkz. Office Çözümlerini Oluşturma ve Hatalarını Ayıklama.
Outlook için uygulama düzeyi eklentileri dağıtma: Daha fazla bilgi için bkz. Office Çözümlerini Dağıtma.