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

  • Makale

Bu giriş niteliğindeki kılavuzda, Microsoft Office Excel için uygulama düzeyinde bir Eklentinin nasıl oluşturulacağı gösterilmektedir. Bu tür bir çözümde oluşturduğunuz özellikler, hangi çalışma kitaplarının açık olduğuna bakılmaksızın uygulamanın kendisi tarafından kullanılabilir.

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

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

  • Çalışma kitabı kaydedildiğinde çalışma kitabına metin eklemek için Excel'in 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.

  • Excel 2013 veya Excel 2010 .

Proje oluşturma

Visual Studio'da yeni bir Excel 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 Excel 2010 Eklentisi veya Excel 2013 Eklentisi'ni seçin.

  6. Ad kutusuna FirstExcelAddIn yazın.

  7. Tamam'a tıklayın.

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

Kaydedilen çalışma kitabına metin eklemek için kod yazma

Ardından ThisAddIn kod dosyasına kod ekleyin. Yeni kod, etkin çalışma sayfasının ilk satırına ortak metin eklemek için Excel'in nesne modelini kullanır. Etkin çalışma sayfası, kullanıcı çalışma kitabını kaydettiğinde açık olan çalışma sayfasıdı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 Excel'in 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. Excel VSTO Eklentinizi yükleyip kaldırdığında bu olay işleyicileri çağrılır. Yüklendiğinde VSTO Eklentinizi başlatmak ve eklenti kaldırıldığında 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 çalışma kitabına metin satırı eklemek için

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

    Kullanıcı çalışma kitabını kaydettiğinde, olay işleyicisi etkin çalışma sayfasının başına yeni metin ekler.

    void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

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

    this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);

    Çalışma kitabını kaydedildiğinde değiştirmek için, önceki kod örnekleri aşağıdaki nesneleri kullanı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 Excel'in 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ümleri oluşturma.

  2. Excel'de çalışma kitabını kaydedin.

  3. Çalışma kitabına aşağıdaki metnin eklendiğini doğrulayın.

    Bu metin kod kullanılarak eklendi.

  4. Excel'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 VSTO Eklentisi, geliştirme bilgisayarınızda Excel'i her açtığınızda ç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

Excel 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