İzlenecek Yol: Excel için İlk Belge Düzeyi Eklentinizi Yaratma

Makale
08/01/2011

Bu tanıtıcı izlenecek yollar, Microsoft Office Excel için belge düzeyi özelleştirmesinin nasıl oluşturulduğunu gösterir. Bu tarz çözümde oluşturduğunuz özellikler sadece belirli bir çalışma kitabı açıkken kullanılabilir. Belge düzeyi özelleştirmelerini uygulama çapında değişiklik yapmak için kullanamazsınız, örneğin herhangi bir çalışma kitabı açıkken yeni bir Şerit sekmesi görüntüleme gibi.

Uygulama alanı: Bu konudaki bilgiler Excel 2007 ve Excel 2010 uygulamalarının belge 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:

Excel çalışma kitabı projesi oluşturma.
Visual Studio tasarımcısında olan çalışma sayfasına metin ekleme.
Açıldığında özelleştirilmiş çalışma sayfasına metin eklemek için Excel nesne modelini kullanan kod yazma.
Sınamak için projeyi oluşturma ve çalıştırma.
Gereksiz yapı dosyalarını ve geliştirme bilgisayarından güvenlik ayarlarını kaldırmak için tüm 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. 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 Excel 2007 ya da Excel 2010.

Projeyi Oluşturma

Visual Studio'da yeni Excel çalışma kitabı projesi yaratmak için

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 Excel 2007 yüklü ise 2007'ı veya Excel 2010 yüklüyse 2010'i seçin.
Proje şablonları listesinde Excel 2007 Çalışma Kitabı'nı ya da Excel 2010 Çalışma Kitabı'nı seçin.
Ad metin kutusuna FirstWorkbookCustomization yazın.
Tamam düğmesini tıklatın.

Office için Visual Studio Araçları Sihirbaz'ı açılır.
Yeni belge oluştur'u seçin ve Tamam'ı tıklatın.
- Visual Studio, FirstWorkbookCustomization projesini oluşturur ve aşağıdaki dosyaları projeye ekler.
- FirstWorkbookCustomization.xlsx - Projedeki Excel çalışma kitabını temsil eder. Tüm çalışma sayfalarını ve grafikleri içerir.
- Sheet1 (Visual Basic için .vb dosyası veya Visual C# için .cs dosyası)- Tasarım yüzeyi ve çalışma kitabındaki ilk çalışma sayfası için kod sağlayan bir çalışma safyası. Daha fazla bilgi için bkz. Çalışma Sayfası Konak Öğesi.
- Sheet2 (Visual Basic için .vb dosyası veya Visual C# için .cs dosyası)- Tasarım yüzeyi ve çalışma kitabındaki ikinci çalışma sayfası için kod sağlayan bir çalışma safyası.
- Sheet3 (Visual Basic için .vb dosyası veya Visual C# için .cs dosyası)- Tasarım yüzeyi ve çalışma kitabındaki üçüncü çalışma sayfası için kod sağlayan bir çalışma safyası.
- ThisWorkbook (Visual Basic için .vb dosyası veya Visual C# için .cs dosyası)- Tasarım yüzeyi ve çalışma kitabı düzeyi özelleştirmeleri içerir. Daha fazla bilgi için bkz. Workbook (Çalışma Kitabı) Konak Öğesi.
Sheet1 kod dosyası tasarımcıda otomatik olarak açılır.

Tasarımcıdaki Çalışma Sayfalarını Kapatma ve Yeniden Açma

Projenizi geliştirirken kasıtlı olarak veya kazara tasarımcıdaki çalışma kitabını veya çalışma sayfasını kapatırsanız, belgeyi yeniden açabilirsiniz.

Tasarımcıdaki çalışma sayfasını kapatmak ve yeniden açmak için

Tasarımcı penceresinin Close (X) düğmesine tıklayarak çalışma kitabını kapatın.
Çözüm Gezgini'de Sheet1 kod dosyasını sağ tıklayın ve Tasarımcıyı Görüntüle'yi tıklayın.

- veya -

Çözüm Gezgini'nde Sheet1 kod dosyasına çift tıklayın.

Tasarımcıdaki Çalışma Sayfasına Metin Ekleme

Özelleştirmenizin kullanıcı arayüzünü (UI) tasarımcıda açık olan çalışma sayfasını değiştirerek tasarlayabilirsiniz. Örneğin, hücrelere metin ekleyebilir, formüller uygulayabilir veya Excel denetimleri ekleyebilirsiniz. Tasarımcının nasıl kullanılacağı hakkında daha fazla bilgi için bkz. Visual Studio Ortamında Office Projeleri.

Tasarımcıyı kullanarak çalışma sayfasına metin eklemek için

Tasarımcıda açılan çalışma sayfasında, A1 hücresini seçin ve aşağıdaki metni yazın.

Bu metin tasarımcı kullanılarak eklenmiştir.

Uyarı
Eğer metnin bu satırını A2 hücresine eklediyseniz, bu örnekteki başka bir kod tarafından yeniden yazılır.

Çalışma Sayfasına Programlı Olarak Metin Ekleme

Sonra, kodu Sheet1 kod dosyasına ekleyin. Yeni kod, metnin ikinci satırını çalışma kitabına eklemek için Excel nesne modelini kullanır. Varsayılan olarak Sheet1 kod dosyası aşağıdaki oluşturulmuş kodu içerir:

Çalışma kitabının programlama modelini gösteren ve Excel nesne modeline erişimini sağlayan Sheet1 sınıfının kısmi tanımıdır. Daha fazla bilgi için, bkz. Çalışma Sayfası Konak Öğesi ve Word Nesne Modeline Genel Bakış. Sheet1 sınıfının geri kalanı değiştirmemeniz gereken gizli bir kod dosyasında tanımlanmıştır.
Sheet1_Startup ve Sheet1_Shutdown olay işleyicileri. Bu olay işleyicileri, Excel sizin özelleştirmenizi yüklediğinde ve kaldırdığında çağırılır. Özelleştirmeniz yüklendiğinde eklentinizi başlatmak ve kaldırıldığında özelleştirmenizin kullandığı kaynakları temizlemek için bu olay işleyicilerini kullanın. Daha fazla bilgi için bkz. Office Projelerindeki Olaylar.

Kod kullanarak metnin ikinci satırı çalışma sayfasına eklemek için

Çözüm Gezgini)'de Sheet1'e sağ tıklayın ve ardından Kodu Göster'i tıklayın.

Kod dosyası Visual Studio'da açılır.

Sheet1_Startup olay işleyicisini aşağıdaki kod ile değiştirin. Sheet1 açıldığında bu kod metnin ikinci satırını çalışma sayfasına ekler.

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
    nr.Value2 = "This text was added by using code"
End Sub

private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2", missing], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Projeyi Sınama

Çalışma kitabınızı sınamak için

Projeyi derlemek ve çalıştırmak için F5'e basın.

Projeyi derlediğinizde kod çalışma kitabıyla ilişkilendirilen bir derleyiciye derlenir. Visual Studio çalışma kitabının ve derleyicinin kopyasını yapı çıktı dosyasına koyar ve özelleştirmenin çalışması 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ış.
Çalışma kitabında, aşağıdaki metni gördüğünüzü doğrulayın.

Bu metin tasarımcı kullanılarak eklenmiştir.

Bu metin kod kullanılarak eklenmiştir.
Çalışma kitabını kapatın.

Projeyi Temizleme

Projeyi geliştirmeyi bitirdiğinizde yapı çıktı klasöründeki dosyaları ve yapı işlemi tarafından oluşturulmuş güvenlik ayarlarını kaldırmalısınız.

Geliştirici bilgisayarınızdaki tamamlanmış projeyi temizlemek için

Visual Studio Build (Yapı) menüsünde Clean Solution'a (Çözümü Temizle) tıklayın.

Sonraki Adımlar

Excel için basit belge düzeyi özelleştirmesi oluşturdunuz, özelleştirmeleri nasıl geliştireceğiniz hakkında daha fazlasını bu konulardan öğrenebilirsiniz:

Belge düzeyi özelleştirmelerinde gerçekleştirebileceğiniz genel programlama görevleri: Belge Düzeyi Özelleştirmelerini Programlama.
Excel belge düzeyi özelleştirmelerine özel programlama görevleri: Excel Çözümleri.
Excel nesne modelini kullanma: Excel Nesne Modeline Genel Bakış.
Excel'in UI'ını özelleştirme, örneğin Şerit'e özel bir sekme ekleme veya kendi eylem bölmenizi oluşturma: Office UI Özelleştirmesi.
Visual Studio'daki Office geliştirme aletlerini kullanarak, Excel nesne modelini kullanarak mümkün olmayan görevleri (örneğin, belgelerdeki yönetilen denetimleri yönetme, Windows Forms veri bağlama modelini kullanarak veriye Excel denetimi bağlama) gerçekleştirmek üzere tarafından sağlanan genişletilmiş Excel nesnelerini kullanma: Genişletilmiş Nesneleri Kullanarak Excel'i Otomatikleştirme.
Excel için belge düzeyi özelleştirmelerini derleme ve hata ayıklama: Office Çözümlerini Oluşturma ve Hatalarını Ayıklama.
Excel için belge düzeyi özelleştirmelerini dağıtma: Office Çözümlerini Dağıtma.