Çalışma kitabı konak öğesi

Konak Workbook öğesi, türü Excel için birincil birlikte çalışma derlemesinden genişleten Workbook bir türdür. Konak Workbook öğesi bir Workbook nesneyle aynı özelliklerin, yöntemlerin ve olayların tümünü sağlar, ancak ek özellikler de sağlar.

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

Belge düzeyindeki projelerde, projenizdeki çalışma kitabını temsil eden varsayılan Workbook bir konak öğesi vardır. VSTO Eklenti projelerinde, çalışma zamanında konak öğeleri oluşturabilirsiniz Workbook .

Belge düzeyi projelerinde çalışma kitabı konak öğesini anlama

Projenizdeki çalışma kitabına erişmek için sınıfını ThisWorkbook kullanın. sınıfı, ThisWorkbook özelleştirmenizde çalışma kitabı açıldığında veya kapatıldığında kod çalıştırma gibi temel görevleri gerçekleştirmek için konak öğesinin üyelerine Workbook erişmenizi sağlar. Daha fazla bilgi için bkz . Belge düzeyinde özelleştirmeleri programlama.

sınıfı, ThisWorkbook projenizde kod yazmaya başlayabileceğiniz bir konum sağlar. sınıfı Excel için birincil birlikte çalışma derlemesindeki nesneyle aynı özelliklerin, yöntemlerin ve olayların Workbook tümünü sağladığından, Excel'in nesne modeline erişmek için de kullanabilirsiniz ThisWorkbook . Daha fazla bilgi için bkz . Excel nesne modeline genel bakış.

çalışma kitabı tasarımcısını görüntülemek ve özellikler penceresinde çalışma kitabının özelliklerini ve olaylarını görüntülemek için Çözüm Gezgini'da ThisWorkbook proje öğesine çift tıklayın.

Belge düzeyi projelerinde çalışma kitabı konak öğesinin sınırlamaları

Belge düzeyi projesi yalnızca bir Workbook konak öğesi (yani ThisWorkbook sınıfı) içerebilir. Projenize tasarım zamanında yeni Workbook konak öğeleri ekleyemezsiniz ve belge düzeyinde özelleştirmeden çalışma zamanında yeni Workbook konak öğeleri oluşturamazsınız.

Çalışma zamanında yeni bir Excel çalışma kitabı oluşturursanız, türünde olur Workbook. Konak öğesi olmadığından, herhangi bir konak denetimi veya Windows Forms denetimi içeremez. Çalışma zamanında çalışma kitabı oluşturma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Program aracılığıyla yeni çalışma kitapları oluşturma.

Konak Workbook öğesi, konak denetimleri için kapsayıcı görevi görmüyor. Bu nedenle, çalışma kitabına görünür denetim ekleyemezsiniz, ancak bileşenlerin tüm çalışma sayfaları tarafından paylaşılabilmesi için gibi DataSetbileşenler ekleyebilirsiniz. Belge düzeyindeki bir projede, çalışma kitabı için kullanılabilen bileşenler Araç Kutusu'nun Bileşen sekmesinde, Veri sekmesinde ve Tüm Windows Forms sekmesinde bulunabilir.

Not

Visual Studio'daki Office geliştirme araçları paylaşılan çalışma kitaplarını desteklemez.

VSTO Eklenti projelerindeki çalışma kitabı konak öğelerini anlama

VSTO Eklenti projelerinde, Excel'de açık olan herhangi bir çalışma kitabı için çalışma zamanında bir Workbook konak öğesi oluşturabilirsiniz. Konak Workbook öğesi oluşturmak için yöntemini kullanın GetVstoObject . Daha fazla bilgi için bkz . Çalışma zamanında VSTO Eklentilerinde Word belgelerini ve Excel çalışma kitaplarını genişletme.