Office Projelerinde Hata Ayıklama

Office projelerinde aynı Microsoft kullanarak ayıklayabilirsiniz Visual Studio , kullanmanız için diğer araçları Visual Studio projeleri.Visual Studiohata ayıklayıcı, kesme noktaları ekleme ve değişkenleri görüntüleme gibi özellikleri Locals penceresi, siz Office 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.

İpucu
Hata ayıklama işlemini basitleştirmek için önce yapı ve hata ayıklama Office uygulamasının tüm örneklerini kapatın.

Uygulama hedefi: Bu konudaki bilgiler, Office 2013 ve Office 2010 için belge düzeyi projeler ve uygulama düzeyi projelere yöneliktir. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.

İlgili video gösterimi için bkz: nasıl ı: Debug VSTO uygulamasında?.

Hata Ayıklamayı Başlatma ve Durdurma

Diğer hata ayıklamayı başlattığınız gibi Office projesinde hata ayıklama Başlat Visual Studio projeleri; Örneğin, F5 tuşuna basabilirsiniz.Uygulama düzeyi eklenti projesinde hata ayıklamaya başladığınızda, hedeflenen Office uygulaması için yeni bir işlem başlatılır ve eklenti yüklenir.Belge düzeyi bir projede hata ayıklamaya başladığınızda, belge veya çalışma kitabı yeni bir Word veya Excel işleminde açılır.

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.Sona erdirilen Office uygulaması açık diğer belgelere de uyarılmadan kapatılır ve kaydedilmemiş tüm değişiklikler kaybolur.Bu hata ayıklayıcı çalışırken açılmış tüm belge veya çalışma kitaplarını kapsayabilir.

Genellikle, böylece, Office uygulaması normal yoldan çıkabilirsiniz işlemden hata ayıklayıcıyı durdurmadan önce ayırmak daha iyidir.Hala hata ayıklayıcı durdurduktan sonra açık bir belge veya çalışma sayfası ile çalışmak istiyorsanız, ayrıca işleminden önce ayırabilirsiniz.

Word için belge düzeyi özelleştirmesinde hata ayıklaması yapıyorsanız, sürekli olarak hata ayıklayıcıyı durdurmadan ve aniden kapanmasına neden bozulmasını Normal şablonuna yol açabilir.Böyle olursa bozulmuş Normal şablonunu silebilirisiniz ve Word'u bir dahaki açışınızda şablon otomatik olarak yeniden oluşturulacaktır.Fakat Normal şablonunda kaydedilmiş hiçbir makro yeniden oluşturulmaz.

F10 ve F11 Davranışları

Office projesinde hata ayıklamaya başladığınızda F10 ve F11 tuşları, Visual Basic veya C# projelerinde hata ayıklama başlattığınızdaki gibi davranmaz.Visual Basic veya C# projelerinde hata ayıklayıcı main işlevde durur, Visual Studio'nun Office uygulamalarının main işlevi üzerinde denetimi yoktur.Fakat, hata ayıklama sırasında F10 ve F11 Visual Basic ve C# projelerindeki aynı işleve sahiptir.

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

Yönetilen kodun, yönetilmeyen kodla etkileşim yolu yüzünden Visual Studio, Microsoft Office uygulamaları tarafından oluşturulan hataları görüntülemez.Örneğin, Visual Studio'daki Office geliştirme araçları kullanılarak oluşturulan eklenti özel bir durum görüntülerse, Microsoft Office uygulaması hata görüntülemeden devam eder.Bu hataları görmek için, ortak dil çalışma zamanı özel durumlarını ayırması için hata ayıklayıcıyı ayarlayın.Daha fazla bilgi için bkz. Nasıl Yapılır: Özel Durum Oluştuğunda Kesme.

Ortak dil çalışma zamanı özel durumlarını ayırmak için hata ayıklayıcı ayarlarsanız, tüm özel durumları şimdi hangi projenizle ilgili olmayabilir işlediğiniz ve çalışma zamanının kendisinden bazı ilk şans özel durumları da dahil olmak üzere, hata ayıklayıcı içine çalışmamasına neden olur.msosec bulunmamasını gösteren hatalar her projede görünür fakat onları yoksaymak güvenlidir.msosec özel durumları çözümünüzü etkilemez.

Ayrıca projenizin çevresindeki Try...Catch bildirimlerini de aykırı durumları yakalamak için kullanabilirsiniz.

Varsayılan olarak, Visual Studio, Office projeleri için Just-In-Time hata ayıklama hatalarını görüntülemez; fakat oluşan özellikleri görebilmek için siz bu özelliği etkinleştirebilirsiniz.Daha fazla bilgi için bkz. Visual Studio'da Tam Zamanında Hata Ayıklama.

Komut Satırı Değişkenleri

Debug (Hata Ayıkla) özelliğinde Start Action (Eyleme Başla) Start Project'e (Projeyi Başlat) ayarlandıysa başlangıç ayarı olarak komut satırı değişkenlerini belirtseniz bile Visual Studio komut satırı değişkenlerini kullanmaz.Hata ayıklamaya başladığınızda komut satırı değişkenlerini kullanmak istiyorsanız Start Project'i (Projeyi Başlat) değil de Start Action'ı (Eyleme Başla) seçmelisiniz.

Kaynak Denetimi

Hata ayıklama özellikleri kaynak denetimi altında birden çok kullanıcı tarafından paylaşılamaz.Visual Basic ve Visual C# projeleri, hata ayıklama özelliklerini kullanıcıya özel bir dosyada saklamak (ProjectName. vbproj.user veya ProjectName. csproj.user), ve bu dosya kaynak denetimi altında değildir.Eğer birden çok kişi hata ayıklıyorsa, her kişi hata ayıklama özelliklerini el ile girmelidir.

Önbelleğe alınmış veri kümelerinde belge düzeyi projelerinde hata ayıklama

Projeyi her derlediğinizde veri kümesi boşaltılır ve yeniden oluşturulur.Önbelleğe alınmış bir veri kümesinde hata ayıklamak istiyorsanız belgeyi Visual Studio dışında açmalı ve sonra hata ayıklayıcıyı bağlamalısınız.

Word 97-2003 (*.doc) Biçimindeki Word Belge Projelerinde Hata Ayıklama

Word 97-2003 (*.doc) biçimindeki Word Belge projelerinde hata ayıklamak için proje klasörünü güvenilir klasörler listesine eklemelisiniz.Bunun nasıl yapılacağı hakkında daha fazla bilgi için bkz: Belgelere Güven Verme...

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

Microsoft Office uygulamalarının beklenmedik bir şekilde davranan 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.

Microsoft Office uygulamalarının eklentileri kullanmak devre dışı bırakmanın iki türü vardır: katı ve Yumuşak devre dışı bırakma.

Katı Devre Dışı Bırakma

Sabit devre dışı bir eklenti uygulamanın beklenmedik şekilde kapanmasına sebep olduğunda oluşabilir.Siz çalışırken hata ayıklayıcıyı, ayrıca geliştirme bilgisayarınızda ortaya çıkabilir Startup olay işleyicisinde eklentinizi yürütülüyor.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 o Office uygulaması için Visual Studio'daki Office geliştirme araçları kullanılarak oluşturulan eklentiler yüklenmeye devam eder.

Yumuşak Devre Dışı Bırakma

Bir uygulamanın beklenmedik şekilde kapanmasına neden olmayacak bir hata üretir yumuşak devre dışı bırakma ortaya çıkabilir.Sırasında işlenmeyen bir özel durum atar, örneğin, bir uygulama yumuşak bir eklentiyi devre dışı Startup olay işleyicisi yürütülüyor.Bir eklentiyi yumuşak devre dışı olduğunda görünür etkin olmayan uygulama eklentileri uygulama ve uygulama listesinde değerini değiştirir LoadBehavior kayıt defteri girdisi için eklenti kaldırılmış olduğunu belirtmek.Hakkında daha fazla bilgi için LoadBehavior kayıt defteri girdisi, bkz: Uygulama Düzeyi Eklentileri İçin Kayıt Defteri Girdileri.

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

Office çalışma zamanı için Visual Studio Araçları Office çözümleri yüklediğinizde veya yükleyen atılan tüm özel durumlar için Olay Görüntüleyicisi'nde Windows iletileri yazar.Bu iletileri yükleme ve dağıtım sorunlarını gidermek için kullanabilirsiniz.

Başlatma hataları bir günlük dosyası ve hata iletilerini kullanarak sorun giderme

Office çalışma zamanı için Visual Studio Araçları 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.Office çalışma zamanı için Visual Studio Araçları Eklenti için dağıtım bildirimini içeren klasörde veya belge veya özelleştirme ile ilişkili çalışma kitabını içeren klasörü günlük dosyası oluşturur.Başarısız olursa, Office çalışma zamanı için Visual Studio Araçları günlük dosyası yerel % TEMP % klasöründe oluşturur.Uygulama düzeyi eklentileri için varsayılan ad olan add-in name. vsto.log.Belge düzeyi projeleri için günlük dosyasının adı olan document name.extensionExcelWorkbook1.xlsx.log gibi .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

Diğer Kaynaklar

Office Çözümleri Oluşturma

Uygulama Düzeyi Eklentileri Programlama