İzlenecek yol: Excel için ilk belge düzeyi özelleştirmenizi oluşturma

  • Makale

Bu giriş niteliğindeki kılavuzda, Microsoft Office Excel için belge düzeyinde özelleştirmenin nasıl oluşturulacağı gösterilmektedir. Bu tür bir çözümde oluşturduğunuz özellikler yalnızca belirli bir çalışma kitabı açık olduğunda kullanılabilir. Uygulama genelinde değişiklikler yapmak için belge düzeyinde özelleştirme kullanamazsınız; örneğin, herhangi bir çalışma kitabı açıkken yeni bir Şerit sekmesi görüntüleyebilirsiniz.

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

  • Excel çalışma kitabı projesi oluşturma.

  • Visual Studio tasarımcısında barındırılan bir çalışma sayfasına metin ekleme.

  • Açıldığında özelleştirilmiş çalışma sayfasına metin eklemek için Excel'in nesne modelini kullanan kod yazma.

  • Test etmek için projeyi oluşturma ve çalıştırma.

  • Geliştirme bilgisayarınızdan gereksiz derleme dosyalarını ve güvenlik ayarlarını kaldırmak 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 çalışma kitabı 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. Yeni Proje Oluştur iletişim kutusunda Excel VSTO Çalışma Kitabı projesini seçin.

    Not

    Yeni Proje Oluştur iletişim kutusunun üst kısmındaki Arama metin kutusuna Office ürününün adını yazarak da şablon arayabilirsiniz. Örneğin, Excel yazıldığında Excel için tüm proje şablonları gösterilir. Ayrıca, Proje türü açılan kutusunda Office'i seçerek şablon listesini yalnızca Office şablonlarını gösterecek şekilde filtreleyebilirsiniz. Daha fazla bilgi için bkz. Visual Studio'da yeni proje oluşturma.

  4. İleri'ye tıklayın.

  5. Yeni projenizi yapılandırın iletişim kutusundaki Ad kutusuna FirstWorkbookCustomization yazın ve Oluştur'a tıklayın.

  6. Office Proje sihirbazı için Visual Studio Araçları Yeni belge oluştur'u seçin ve Tamam'a tıklayın.

    • Visual Studio, FirstWorkbookCustomization projesini oluşturur ve projeye aşağıdaki dosyaları ekler.

    • FirstWorkbookCustomization.xlsx - Projedeki Excel çalışma kitabını temsil eder. Tüm çalışma sayfalarını ve grafikleri içerir.

    • Sayfa1 (Visual Basic için .vb dosyası veya Visual C# için .cs dosyası) - Çalışma kitabındaki ilk çalışma sayfasının tasarım yüzeyini ve kodunu sağlayan çalışma sayfası. Daha fazla bilgi için bkz . Çalışma sayfası konak öğesi.

    • Sayfa2 (Visual Basic için .vb dosyası veya Visual C# için .cs dosyası) - Çalışma kitabındaki ikinci çalışma sayfasının tasarım yüzeyini ve kodunu sağlayan bir çalışma sayfası.

    • Sayfa3 (Visual Basic için .vb dosyası veya Visual C# için .cs dosyası) - Tasarım yüzeyini ve çalışma kitabındaki üçüncü çalışma sayfasının kodunu sağlayan bir çalışma sayfası.

    • ThisWorkbook (Visual Basic için.vb dosyası veya Visual C# için .cs dosyası) - Tasarım yüzeyini ve çalışma kitabı düzeyinde özelleştirmelerin kodunu içerir. Daha fazla bilgi için bkz . Çalışma kitabı konak öğesi.

      Sayfa1 kod dosyası tasarımcıda otomatik olarak açılır.

Tasarımcıda çalışma sayfalarını kapatma ve yeniden açma

Projenizi geliştirirken tasarımcıdaki bir çalışma kitabını veya çalışma sayfasını bilerek veya yanlışlıkla kapatırsanız, yeniden açabilirsiniz.

Tasarımcıda çalışma sayfasını kapatıp yeniden açmak için

  1. Tasarımcı penceresinin Kapat düğmesine (X) tıklayarak çalışma kitabını kapatın.

  2. Çözüm Gezgini Sayfa1 kod dosyasına sağ tıklayın ve Tasarım Aracı Görüntüle'ye tıklayın.

    - veya -

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

Tasarımcıda çalışma sayfasına metin ekleme

Tasarımcıda açık olan çalışma sayfasını değiştirerek özelleştirmenizin kullanıcı arabirimini (UI) tasarlayabilirsiniz. Örneğin, hücrelere metin ekleyebilir, formül uygulayabilir veya Excel denetimleri ekleyebilirsiniz. Tasarımcıyı kullanma hakkında daha fazla bilgi için bkz . Visual Studio ortamındaki Office projeleri.

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

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

    Bu metin tasarımcı kullanılarak eklendi.

Uyarı

Bu metin satırını A2 hücresine eklerseniz, bu örnekteki diğer kodlar bu satırın üzerine yazılır.

Çalışma sayfasına program aracılığıyla metin ekleme

Ardından, Sayfa1 kod dosyasına kod ekleyin. Yeni kod, çalışma kitabına ikinci bir metin satırı eklemek için Excel'in nesne modelini kullanır. Varsayılan olarak, Sayfa1 kod dosyası aşağıdaki oluşturulan kodu içerir:

  • Çalışma sayfasının programlama modelini temsil eden ve Excel'in nesne modeline erişim sağlayan sınıfın kısmi tanımı Sheet1 . Daha fazla bilgi için Çalışma sayfası konak öğesine ve Word nesne modeline genel bakış. Sınıfın Sheet1 geri kalanı, değiştirmemeniz gereken gizli bir kod dosyasında tanımlanır.

  • Sheet1_Startup ve Sheet1_Shutdown olay işleyicileri. Excel özelleştirmenizi yükleyip kaldırdığında bu olay işleyicileri çağrılır. Yüklendiğinde özelleştirmenizi başlatmak ve kaldırıldığında özelleştirmeniz tarafından kullanılan kaynakları temizlemek için bu olay işleyicilerini kullanın. Daha fazla bilgi için bkz . Office projelerindeki olaylar.

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

  1. Çözüm Gezgini'da Sayfa1'e sağ tıklayın ve ardından Kodu Görüntüle'ye tıklayın.

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

  2. Olay işleyicisini Sheet1_Startup aşağıdaki kodla değiştirin. Sayfa1 açıldığında, bu kod çalışma sayfasına ikinci bir metin satırı ekler.

    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ı test etmek için

  1. Projenizi oluşturmak ve çalıştırmak için F5 tuşuna basın.

    Projeyi oluşturduğunuzda, kod çalışma kitabıyla ilişkilendirilmiş bir derlemede derlenmiş. Visual Studio, çalışma kitabının ve derlemenin bir kopyasını projenin derleme çıktı klasörüne yerleştirir ve özelleştirmenin çalışmasını sağlamak için geliştirme bilgisayarındaki güvenlik ayarlarını yapılandırır. Daha fazla bilgi için bkz . Office çözümleri oluşturma.

  2. Çalışma kitabında aşağıdaki metni gördüğünüzden emin olun.

    Bu metin tasarımcı kullanılarak eklendi.

    Bu metin kod kullanılarak eklendi.

  3. Çalışma kitabını kapatın.

Projeyi temizleme

Proje geliştirmeyi bitirdiğinizde, derleme çıktı klasöründeki dosyaları ve derleme işlemi tarafından oluşturulan güvenlik ayarlarını kaldırmanız gerekir.

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 belge düzeyinde özelleştirme oluşturduğunuza göre, şu konularda özelleştirme geliştirme hakkında daha fazla bilgi edinebilirsiniz:

  • Belge düzeyi özelleştirmelerinde gerçekleştirebileceğiniz genel programlama görevleri: Belge düzeyi özelleştirmelerini programla.

  • Excel için belge düzeyi özelleştirmelerine ö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 eylemlerinizi oluşturarak Excel kullanıcı arabirimini özelleştirme: Office kullanıcı arabirimi özelleştirmesi.

  • Excel nesne modelini kullanarak mümkün olmayan görevleri gerçekleştirmek için Visual Studio'da Office geliştirme araçları tarafından sağlanan genişletilmiş Excel nesnelerini kullanma (örneğin, belgelerde yönetilen denetimleri barındırma ve Windows Forms veri bağlama modelini kullanarak Excel denetimlerini verilere bağlama): Genişletilmiş nesneleri kullanarak Excel'i otomatikleştirin.

  • Excel için belge düzeyinde özelleştirmeler oluşturma ve hata ayıklama: Office çözümleri oluşturma.

  • Excel için belge düzeyi özelleştirmeleri dağıtma: Office çözümü dağıtma.

İlgili içerik