Uygulama Düzeyi Projelerinde Hata Ayıklama

Uygulama düzeyi projelerinde diğer Visual Studio projeleriniz için kullandığınız aynı Microsoft Visual Studio araçlarıyla hata ayıklayabilirsiniz. Kesme noktaları ekleme ve Yerel Değişkenler penceresindeki değişkenleri görüntüleme gibi Visual Studio hata ayıklama özellikleri aynı zamanda uygulama düzeyi projelerinizde hata ayıkladığınızda da kullanılabilir. Visual Studio hata ayıklama araçları hakkında daha fazla bilgi için, bkz. Visual Studio'da hata ayıklama. Uygulama düzeyi projeleri hakkında daha fazla bilgi için, bkz. Uygulama Düzeyi Eklentisi Mimarisi.

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

İlgili video gösterimi için, bkz. Nasıl Yaparım: vsto uygulama hata ayıklama?.

Hata Ayıklamayı Başlatma ve Durdurma

Uygulama düzeyi projelerinde hata ayıklamayı diğer Visual Studio projelerinde hata ayıklamayı başlattığınız gibi başlatabilirsiniz, örneğin, F5 tuşuna basabilirsiniz. Proje hata ayıklamasını başlattığınızda, hedeflenen Office uygulaması için yeni bir işlem başlatılır ve eklenti yüklenir. Hata ayıklayıcıyı durdurduğunuzda, hata ayıklayıcı uygulama işlemini beklenmedik şekilde sonlandırır veya hata ayıklayıcıyı ayırmaya ayarladıysanız ayırır. Daha fazla bilgi için bkz. Debugging Shortcut Keys, Brief Scheme.

Aykırı Durumları Görüntüleme

Visual Studio Office geliştirme araçları kullanılarak oluşturulan eklenti özel durum fırlatırsa Microsoft Office uygulaması, aykırı durumu görüntülemeden devam eder. Eklenti aykırı durumları fırlatıldığında görmek istiyorsanız, hata ayıklayıcıyı tüm aykırı durumlarda duracak şekilde ayarlayın. Daha fazla bilgi için bkz. Nasıl Yapılır: Office Projelerindeki Hataları İşleme.

Aynı zamanda aykırı durum fırlatabilecek kod etrafına Try...Catch ifadeleri ekleyebilirsiniz. Try...Catch ifadelerinin nasıl kullanılacağı hakkında daha fazla bilgi için, bkz. Nasıl Yapılır: Kod bir Try…Catch Blok ile test Visual Temel ve Nasıl Yapılır: Tanıtıcı bir özel durum kullanarak try/catch (C# programlama Kılavuzu).

Devre Dışı Bırakılmış Eklentilerde Hata Ayıklama

Microsoft Office uygulamalarının beklenmedik biçimde davranmasına eklentileri devre dışı bırakabilirsiniz. Microsoft Office uygulaması, sorunlu kodun uygulama her başladığında yüklenmesini engellemek için eklentileri devre dışı bırakır. Yine de genel hata ayıklamada da beklenmedik davranışlara sebep olmak kolaydır. Eklentilerin nasıl yeniden etkinleştirildiği hakkında daha fazla bilgi için, bkz. Nasıl Yapılır: Devre Dışı Bırakılmış Eklentiyi Yeniden Etkinleştirme.

Eklentiler için Microsoft Office uygulamalarının kullandığı iki tür devre dışı bırakma vardır: katı ve yumuşak devre dışı bırakma.

Katı Devre Dışı Bırakma

Bir eklenti uygulama beklenmedik biçimde kapatılmasına neden olan sabit devre dışı bırakılması oluşabilir. Hata ayıklayıcı çalışırken durdurursanız geliştirme bilgisayarınızda da oluşabilir Startup olay işleyicisinde eklentinizi yürütme. Bir eklentiyi sabit devre dışı olduğunda, görünür Devre dışı öğeler uygulama listesinde.

Office uygulaması, Visual Studio Office geliştirme araçları kullanılarak oluşturulan eklentiyi katı olarak devre dışı bırakırsa, uygulama sadece hataya sebep olan eklentiyi devre dışı bırakır. Diğer Office geliştirme araçları Visual Studio için o Office uygulaması kullanılarak oluşturulmuş eklentileri yüklemeye devam eder.

Yumuşak Devre Dışı Bırakma

Bir eklenti uygulama beklenmedik biçimde kapatılmasına neden olmayacak bir hata üretir yumuşak devre dışı bırakılması oluşabilir. Sırasında işlenmeyen bir özel durum atar, örneğin, bir uygulamayı yumuşak bir eklentiyi devre dışı Startup olay işleyicisi yürütülürken. Bir eklenti yumuşak devre dışı olduğunda, görünür Etkin uygulama eklentileri uygulama ve uygulama listesinde değerini değiştirir LoadBehavior kaldırılmış olduğunu belirtmek eklenti için kayıt defteri girdisini. Hakkında daha fazla bilgi için LoadBehavior kayıt defteri girdisi, bkz: Uygulama Düzeyi Eklentileri için Kayıt Defteri Girdileri.

Olay Görüntüleyicisi'ni kullanarak yükleme hatalarında sorun giderme

Visual Studio Tools for Office çalışma zamanı modülü İletileri yüklemek veya kaldırma atılan tüm özel durumlar için Windows Olay Görüntüleyicisi'ne yazarOffice çözümleri. Bu iletiler, yükleme ve dağıtım sorunlarını gidermek için kullanabilirsiniz. Daha fazla bilgi için bkz. Office Çözümleri için Olay Günlüğü.

Bir günlük dosyası ve hata iletileri kullanarak başlatma hataları giderme

Visual Studio Tools for Office çalışma zamanı modülü başlangıç süresince meydana gelen tüm hataları bir günlük dosyasına yazabilir veya her hatayı ileti kutusunda görüntüleyebilir. Varsayılan değer olarak bu seçenekler kapalıdır. Ortam değişkenleri oluşturarak bu seçenekleri açabilirsiniz.

Her hatayı ileti kutusunda görüntülemek için VSTO_SUPPRESSDISPLAYALERTS isimli bir ortam değişkeni oluşturun ve 0'a (sıfır) ayarlayın. İletileri, ortam değişkenini silerek veya 1'e (bir) ayarlayarak gizleyebilirsiniz.

Hataları günlük dosyasına yazmak için VSTO_LOGALERTS isimli ortam değişkeni oluşturun ve 1'e (bir) ayarlayın. Visual Studio Tools for Office çalışma zamanı modülü Eklentisi, dağıtım listesi içeren klasör günlük dosyasında oluşturur veya, başarısız, yerel % temp % klasörüne kopyalayın. Varsayılan ad eklentisi adı. vsto.log. Hataları günlüklemeyi durdurmak için ortam değişkenini silin veya 0'a (sıfır) ayarlayın.

Ayrıca bkz.

Görevler

Nasıl Yapılır: Devre Dışı Bırakılmış Eklentiyi Yeniden Etkinleştirme

Nasıl Yapılır: Office Projelerindeki Hataları İşleme

Diğer Kaynaklar

Office Çözümlerini Oluşturma ve Hatalarını Ayıklama

Uygulama Düzeyi Eklentileri Programlama

Değişiklik Geçmişi

Tarih	Geçmiş	Nedeni
Eylül 2010	Olay Görüntüleyicisi'ni kullanarak yükleme hatalarını giderme hakkında bölümüne eklendi.	Bilgi geliştirme.
Mayıs 2010	Oturum açma hataları hakkındaki bazı ayrıntılar düzeltildi.	İçerik hata düzeltmesi.