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

  • Makale

Bu giriş niteliğindeki kılavuzda, Microsoft Office Word için VSTO Eklentisi oluşturma gösterilmektedir. Bu tür bir çözümde oluşturduğunuz özellikler, hangi belgelerin açık olduğuna bakılmaksızın uygulamanın kendisi tarafından kullanılabilir.

Şunlar için geçerlidir: Bu konudaki bilgiler Word 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.

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

  • Word VSTO Eklenti projesi oluşturma.

  • Kaydedildiğinde belgeye metin eklemek için Word'ün 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 Word

Proje oluşturma

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

  6. Ad kutusuna FirstWordAddIn yazın.

  7. Tamam'a tıklayın.

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

Kaydedilen belgeye metin eklemek için kod yazma

Ardından ThisAddIn kod dosyasına kod ekleyin. Yeni kod, kaydedilen her belgeye ortak metin eklemek için Word'ün 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 Word'ün 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, Word 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.

Kaydedilen belgeye metin paragrafı eklemek için

  1. ThisAddIn kod dosyasında sınıfına ThisAddIn aşağıdaki kodu ekleyin. Yeni kod, bir belge kaydedildiğinde ortaya çıkan olay için DocumentBeforeSave bir olay işleyicisi tanımlar.

    Kullanıcı belgeyi kaydettiğinde, olay işleyicisi belgenin başına yeni metin ekler.

    void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}

    Not

    Bu kod, koleksiyondaki ilk paragrafa Paragraphs erişmek için 1 dizin değerini kullanır. Visual Basic ve Visual C# 0 tabanlı diziler kullansa da, Word nesne modelindeki çoğu koleksiyonun alt dizi sınırları 1'dir. Daha fazla bilgi için bkz . Office çözümlerinde kod yazma.

  2. C# kullanıyorsanız olay işleyicisine ThisAddIn_Startup aşağıdaki gerekli kodu ekleyin. Bu kod, olay işleyicisini Application_DocumentBeforeSaveDocumentBeforeSave olaya bağlamak için kullanılır.

    this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);

    Belge kaydedildiğinde belgeyi değiştirmek için, önceki kod örneklerde aşağıdaki nesneler kullanılır:

Projeyi test etme

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 Word'ün VSTO Eklentisini bulmasını ve 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ümleri oluşturma.

  2. Word'de etkin belgeyi kaydedin.

  3. Belgeye aşağıdaki metnin eklendiğini doğrulayın.

    Bu metin kod kullanılarak eklendi.

  4. Word'i 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ınızda Word'u her açtığınızda VSTO Eklentisi çalışmaya devam eder.

Geliştirme bilgisayarınızda tamamlanmış projeyi temizlemek için

  1. Visual Studio'da, Oluştur menüsünde Çözümü Temizle'ye tıklayın.

Sonraki adımlar

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

İlgili içerik