Office Projeleri Nesnelerine Genel Erişim

Makale
08/01/2011

Office projesi yarattığınızda, Visual Studio otomatik olarak projede Globals isimli bir sınıf oluşturur. Çalışma zamanında birçok farklı proje öğesine projedeki herhangi bir koddan erişmek için Globals sınıfını kullanabilirsiniz.

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ü.

Genel Sınıfları Kullanma

Globals sınıfı projenizdeki belli öğelere başvuru tutan statik bir sınıftır. Globals sınıfını kullanarak çalışma zamanında aşağıdaki öğelere projedeki herhangi bir koddan erişebilirsiniz.

ThisWorkbook Ve Sheetn projesinde Excel çalışma kitabı veya şablon sınıfları. Bu nesneler kullanarak erişebileceğiniz Globals.ThisWorkbook ve Sheetn özellikleri.
ThisDocument Sınıfı bir Word belgesi veya şablonu project. Bu nesne kullanarak erişebileceğiniz Globals.ThisDocument özelliği.
ThisAddIn Sınıfında bir uygulama düzeyinde proje. Bu nesne kullanarak erişebileceğiniz Globals.ThisAddIn özelliği.
Projenizde Şerit Tasarımcısını kullanarak özelleştirdiğiniz tüm Şeritler. Şerit'i kullanarak erişebileceğiniz Globals.Ribbons özelliği. Daha fazla bilgi için bkz. Çalıştırma Zamanında Şerite Erişme.
Outlook eklenti projesindeki tüm Outlook form bölgeleri. Form bölgeleri kullanarak erişebileceğiniz Globals.FormRegions özelliği. Daha fazla bilgi için bkz. Form Bölgesine Çalışma Zamanında Erişme.
Şerit denetimler, etiketler ve ana oluşturmanıza olanak sağlayan bir fabrika nesnesinin projelerde çalışma zamanında hedefleyen öğeleri .NET Framework 4. Bu nesne kullanarak erişebileceğiniz Globals.Factory özelliği. Bu nesne aşağıdaki arayüzlerden birini uygulayan sınıfın bir örneğidir:
Not

Excel 2010 ve Word 2010'de akıllı etiketlerin kullanımı terk edilmiştir. Daha fazla bilgi için bkz. Akıllı Etiketlere Genel Bakış.

Not

Factory özelliği sadece .NET Framework 4'u hedefleyen projeler kullanabilir. Hedefleyen projeler.net Framework 3.5, zamanında şerit denetimleri, akıllı etiketleri ve ana öğeleri oluşturmak için diğer yöntemleri kullanın.

Örneğin, kullanıcı Excel belge düzeyi projesi eylemler bölmesindeki bir düğmeye bastığında Sheet1 üzerindeki NamedRange denetimine metin eklemek için Globals.Sheet1 özelliğini kullanabilirsiniz.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click
    Globals.Sheet1.NamedRange1.Value2 = Me.TextBox1.Text
End Sub

private void button1_Click(object sender, EventArgs e)
{
    Globals.Sheet1.namedRange1.Value2 = this.textBox1.Text;
}

Genel Sınıfları Başlatma

Belge veya eklenti tamamen başlatılmadan Globals sınıfını kullanmaya çalışan kod özel durum fırlatabilir. Örneğin, bir sınıf düzeyi değişkeni tanımlarken Globals'ı kullanma başarısız olabilir, çünkü Globals sınıfı tanımlanmış nesnelerin örneklendirilmesinden önce tüm konak öğelerinin başvuruları ile başlatılmamış olabilir.

Not

Globals sınıfı hiçbir zaman tasarım zamanında başlatılmaz, fakat denetim örnekleri tasarımcı tarafından oluşturulur. Bir özelliği kullanan bir kullanıcı denetimi yaratmak yani Globals class özelliğini döndürüp gelen bir kullanıcı denetimi sınıf içinde yapmanız gerekir null kullanin döndürülen nesne çalışmadan önce