İzlenecek Yol: Excel İçin İlk Belge Düzeyi Özelleştirmeyi Oluşturma

Makale
06/10/2015

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 hedefi: Bu konudaki bilgiler, Excel 2013 ve Excel 2010 için belge düzeyi projelere yöneliktir. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.

Bu örneklerde aşağıdaki görevler gösterilir:

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.
Test etmek 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. Sahip olduğunuz Visual Studio sürümü ve kullandığınız ayarlar bu öğeleri belirler. Daha fazla bilgi için, bkz. Visual Studio'da Geliştirme Ayarlarını özelleştirme.

Önkoşullar

Bu örneği tamamlamak için aşağıdaki bileşenler gerekmektedir:

Microsoft Office geliştirici araçlarını içeren bir Visual Studio 2013 sürümü. Daha fazla bilgi edinmek için, bkz. Office Çözümleri Geliştirmek İçin Bilgisayarı Yapılandırma.
Excel 2013 veya 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'ye tıklatın.
Şablonlar bölmesinde genişletin Visual C# veya Visual Basicve sonra genişletin Office/SharePoint.
Genişletilmiş altında Office/SharePoint düğümü, select Office eklentileri düğümü.
Proje şablonları listesinde Excel 2010 Çalışma Kitabı'nı ya da Excel 2013 Ç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. Ç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"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Projeyi Test Etme

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

Projeyi derlemek ve çalıştırmak için F5'a 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 Oluşturma.
Ç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 için 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, bunun Şerit'e özel bir sekme ekleme veya kendi eylem bölmenizi oluşturma: Office Kullanıcı Arabirimini Özelleştirme.
Excel nesneleri (örneğin, belgelerdeki yönetilen denetimleri yönetme ve Windows Forms veri bağlama modelini kullanarak veriye Excel denetimi bağlama) Excel nesne modelini kullanarak mümkün olmayan görevleri gerçekleştirmek için Visual Studio Office geliştirme araçları tarafından sağlanan genişletilmiş kullanma: Genişletilmiş Nesneleri Kullanarak Excel'i Otomatikleştirme.
Derleme ve hata ayıklama Excel için belge düzeyi özelleştirmeleri: Office Çözümleri Oluşturma.
Excel için belge düzeyi özelleştirmelerini dağıtma: Office Çözümünü Dağıtma.