Office Çözümlerinde Kod Yazma

Makale
08/01/2011

Office projelerinde kod yazmanın Visual Studio'daki diğer tür projelerden farklı olan bazı açıları vardır. Bu farklılıkların birçoğu Office nesne modellerinin yönetilen koda uygulanma yoluyla ilintilidir. Diğer farklılklar Office projelerinin tasarımıyla ilintilidir.

Uygulama alanı: Bu konudaki bilgiler, Microsoft Office 2010 ve 2007 Microsoft Office sisteminin belge düzeyi projelerine ve uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz: Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Yönetilen Kod ve Office Programlama

Tümleşik Microsoft Office çözümlerinin oluşturulmasını mümkün kılan anahtar teknoloji, Component Object Modelinin (COM) teknolojisinin parçası olan Otomasyondur. Otomasyon, herhangi bir uygulama, DLL veya uygun program arayüzlerini destekleyen ActiveX denetimleri tarafından kullanıma sunulan yazılım nesnelerini oluşturmak denetlemek için kod kullanmanızı sağlar.

Birincil Birlikte Çalışma Derlemelerini Anlama

Microsoft Office uygulamaları, işlevlerinin çoğunu Otomasyon'a açar. Ancak, yönetilen kodu (örn. Visual Basic veya C#) doğrudan Office uygulamalarını otomatikleştirmek için kullanamazsınız. Office uygulamalarını yönetilen kod kullanarak otomatikleştirmek için Office birincil birlikte çalışma derlemelerini (PIA) kullanmanız gerekir. Birincil birlikte çalışma derlemeleri yönetilen kodun Office uygulamalarının COM temelli nesne modeliye etkileşime geçmesini sağlar.

Her Microsoft Office uygulamasının bir PIA'i vardır. Visual Studio'da bir Office projesi yarattığınızda, projeye otomatik olarak uygun PIA'e bir başvuru eklenir. Projeden diğer Office uygulamalarının özelliklerini otomatikleştirmek için el ile uygun PIA'e bir başvuru eklemelisiniz. Daha fazla bilgi için bkz. Nasıl Yapılır: Office Uygulamalarını Birincil Birlikte Çalışma Derlemeleriyle Hedefleme.

Tasarım Zamanında ve Çalışma Zamanında Birincil Birlikte Çalışma Derlemelerini Kullanma

Çoğu geliştirme görevini gerçekleştirebilmek için Office PIAlerinin geliştirme bilgisayarınızda genel derleme önbelleğine yüklü ve kayıtlı olması gerekir. Daha fazla bilgi için bkz. Office Çözümeri Geliştirmek İçin Bilgisayarı Yapılandırma.

.NET Framework 3.5'i hedefleyen Office çözümlerinin çalışması için, son kullanıcı bilgisayarlarında da PIA'in yüklü olması lazımdır. Fakat, .NET Framework 4 hedefleyen Office çözümlerinin çalışması için, son kullanıcı bilgisayarlarında Office PIA gerekli değildir. Daha fazla bilgi için bkz. Office Çözümleri Tasarlama ve Oluşturma.

Birincil Birlikte Çalışma Derlemesinde Türleri Kullanma

Office PIA Office uygulamalarının nesne modeli açığa çıkaran türleri ve doğrudan kodunuzda kullanılması amaçlanmamıştır ek altyapı türleri birleşimini içerir. Office PIA türlerinde genel bakış için bkz: Overview of Classes and Interfaces in the Office Primary Interop Assemblies.

Office PIAlerindeki türler COM temelli nesne modelindeki türlere karşılık geldiği için bu türleri kullanış yolunuz çoğu zaman diğer yönetilen türlerden farklıdır. Örneğin, bir Office birincil birlikte çalışma derlemesinde isteğe bağlı parametreleri olan yöntemleri çağırma yolunuz projede kullandığınız programlama diline bağlıdır. Daha ayrıntılı bilgi için aşağıdaki konulara bakın:

Office Projelerinin Modelini Programlama

Bütün Office projeleri kodunuza giriş noktasını sağlayan bir ya da daha fazla oluşturulmuş sınıf içerir. Bu sınıflar ayrıca konak uygulamanın nesne modeline ve eylemler bölmesi, özel görev bölmesi gibi özelliklere erişim sağlar.

Oluşturulmuş Sınıfları Anlama

Excel ve Word için belge düzeyi projelerde, oluşturulmuş sınıf uygulamanın nesne modelindeki üst düzey nesneye benzer. Örneğin, Word belge düzeyi projesindeki oluşturulmuş ThisDocument sınıfı, Word nesne modelindeki Microsoft.Office.Interop.Word.Document sınıfıyla aynı üyeleri sağlar. Belge düzeyi projelerinde, oluşturulmuş sınıflar hakkında daha fazla bilgi için, bkz. Belge Düzeyi Özelleştirmelerini Programlama.

Uygulama düzeyi projeleri ThisAddIn adında bir oluşturulmuş sınıf sunar. Bu sınıf, konak uygulamasının nesne modelindeki bir sınıfa benzemez. Bunun yerine, bu sınıf eklentinin kendisini temsil eder ve bu sınıfı konak uygulamasının nesne modeline eklentilerde kullanılabilir olan diğer özelliklerine erişmek için kullanabilirsiniz. Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentileri Programlama.

Office rojelerindeki bütün oluşturulmuş sınıflar Startup ve Shutdown olay işleyicilerini içerir. Kod yazmaya başlamak için genellikle bu olay işleyicilerine kod eklersiniz. Eklentinizi başlatmak için Startup olay işleyicisine kod ekleyebilirsiniz. Eklentinizin kullandığı kaynakları temizlemek için Shutdown olay işleyicisine kod ekleyebilirsiniz. Daha fazla bilgi için bkz. Office Projelerindeki Olaylar.

Çalıştırma Zamanında Oluşturulmuş Sınıflara Erişme

Bir Office çözümü yüklendiğinde Visual Studio Tools for Office çalışma zamanı modülü projenizdeki her bir oluşturulmuş sınıfı başlatır. Bu nesneler projenizdeki herhangi bir kodda Globals sınıfını kullanarak erişebilirsiniz. Örneğin, bir uygulama düzeyi eklentisinde, Globals sınıfını, bir Şerit düğmesinin olay işleyicisinden ThisAddIn sınıfındaki kodu çağırmak için kullanabilirsiniz.

Daha fazla bilgi için bkz. Office Projeleri Nesnelerine Genel Erişim.