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

  • Makale

Bu kılavuzda, Microsoft Office Outlook için VSTO Eklentisi'nin nasıl oluşturulacağı gösterilmektedir. Bu tür bir çözümde oluşturduğunuz özellikler, hangi Outlook öğesinin 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 Outlook 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.

Not

Office deneyimini birden çok platformda genişleten çözümler geliştirmek mi ilginizi çekiyor? Yeni Office Eklentileri modeline göz atın. Office Eklentileri, VSTO Eklentileri ve çözümleriyle karşılaştırıldığında küçük bir ayak izine sahiptir ve HTML5, JavaScript, CSS3 ve XML gibi neredeyse tüm web programlama teknolojisini kullanarak bunları oluşturabilirsiniz.

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

  • Outlook için Outlook VSTO Eklenti projesi oluşturma.

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

  • Microsoft Outlook

Proje oluşturma

Visual Studio'da yeni bir Outlook projesi 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 bir Outlook VSTO Eklenti projesi seçin.

  6. Ad kutusuna FirstOutlookAddIn yazın.

  7. Tamam'a tıklayın.

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

Her yeni posta iletisine metin ekleyen kod yazma

Ardından ThisAddIn kod dosyasına kod ekleyin. Yeni kod, her yeni posta iletisine metin eklemek için Outlook'un 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 Outlook'un 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. Bu olay işleyicileri, Outlook VSTO Eklentinizi yükleyip kaldırdığında ç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.

Her yeni posta iletisinin konusuna ve gövdesine metin eklemek için

  1. ThisAddIn kod dosyasında sınıfında adlı inspectorsThisAddIn bir alan bildirin. alanı, inspectors geçerli Outlook örneğindeki Denetçi pencerelerinin koleksiyonuna bir başvuru tutar. Bu başvuru, çöp toplayıcının olay için olay işleyicisini içeren belleği boşaltmasını NewInspector engeller.

    Outlook.Inspectors inspectors;

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

    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 sınıfına ThisAddIn aşağıdaki kodu ekleyin. Bu kod, olay için bir olay işleyicisi NewInspector tanımlar.

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

    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, önceki kod örnekleri aşağıdaki nesneleri kullanır:

  • Application Sınıfının alanıThisAddIn. alanı, Outlook'un Application geçerli örneğini temsil eden bir Application nesne döndürür.

  • Olay Inspector için olay işleyicisinin NewInspector parametresi. Inspector parametresi, yeni posta iletisinin Denetçi penceresini temsil eden bir Inspector nesnedir. Daha fazla bilgi için bkz . Outlook çözümleri.

Projeyi test etme

Projeyi derleyip çalıştırdığınızda, metnin yeni bir posta iletisinin konu satırında ve gövdesinde 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.

    Projeyi oluşturduğunuzda kod, projenin derleme çıktı klasörüne dahil edilen bir derlemede derlenmiştir. Visual Studio ayrıca Outlook'un 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. Outlook'ta yeni bir posta iletisi oluşturun.

  3. Aşağıdaki metnin iletinin hem konu satırına hem de gövdesine eklendiğini doğrulayın.

    Bu metin kod kullanılarak eklendi.

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

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

  • Outlook için VSTO Eklentilerini kullanarak gerçekleştirebileceğiniz genel programlama görevleri. Daha fazla bilgi için bkz . PROGRAM VSTO Eklentileri.

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

  • Örneğin, Şerit'e özel bir sekme ekleyerek veya kendi özel görev bölmenizi oluşturarak Outlook'un kullanıcı arabirimini özelleştirme. Daha fazla bilgi için bkz . Office kullanıcı arabirimi özelleştirmesi.

  • Outlook için VSTO Eklentileri oluşturma ve hata ayıklama. Daha fazla bilgi için bkz . Office çözümleri oluşturma.

  • Outlook için VSTO Eklentileri Dağıtma. Daha fazla bilgi için bkz . Office çözümü dağıtma.

İlgili içerik