İzlenecek yol: Excel için ilk VSTO Eklentinizi oluşturma
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
Visual Studio’yu çalıştırın.
Dosya menüsünde Yeni'nin üzerine gelin ve Proje'ye tıklayın.
Şablonlar bölmesinde Visual C# veya Visual Basic'i ve ardından Office/SharePoint'i genişletin.
Genişletilmiş Office/SharePoint düğümü altında Office Eklentileri düğümünü seçin.
Proje şablonları listesinde Excel 2010 Eklentisi veya Excel 2013 Eklentisi'ni seçin.
Ad kutusuna FirstExcelAddIn yazın.
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ınThisAddIn
geri kalanı, değiştirmemeniz gereken gizli bir kod dosyasında tanımlanır.ThisAddIn_Startup
veThisAddIn_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
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"; }
C# kullanıyorsanız olay işleyicisine
ThisAddIn_Startup
aşağıdaki gerekli kodu ekleyin. Bu kod, olay işleyicisiniApplication_WorkbookBeforeSave
WorkbookBeforeSave 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:
Application
Sınıfının alanıThisAddIn
. alanı, Excel'inApplication
geçerli örneğini temsil eden bir Application nesne döndürür.Olay
Wb
için olay işleyicisinin WorkbookBeforeSave parametresi.Wb
parametresi, kaydedilen çalışma kitabını temsil eden bir Workbook nesnedir. Daha fazla bilgi için bkz . Excel nesne modeline genel bakış.
Projeyi test etme
Projeyi test etmek için
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.
Excel'de çalışma kitabını kaydedin.
Çalışma kitabına aşağıdaki metnin eklendiğini doğrulayın.
Bu metin kod kullanılarak eklendi.
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
- 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:
VSTO Eklentilerinde gerçekleştirebileceğiniz genel programlama görevleri: PROGRAM VSTO Eklentileri.
Excel VSTO Eklentilerine özgü programlama görevleri: Excel çözümleri.
Excel'in nesne modelini kullanma: Excel nesne modeline genel bakış.
Örneğin, Şerit'e özel bir sekme ekleyerek veya kendi özel görev bölmenizi oluşturarak Excel'in kullanıcı arabirimini (UI) özelleştirme: Office UI özelleştirmesi.
Excel için VSTO Eklentileri oluşturma ve hata ayıklama: Office çözümleri oluşturma.
Excel için VSTO Eklentileri Dağıtma: Office çözümü dağıtma.