Belge Düzeyi Projelerinde Hata Ayıklama

Microsoft Office Word ve Microsoft Office Excel belge düzeyi projelerinde diğer projeleriniz için kullandığınız aynı Visual Studio araçlarıyla hata ayıklayabilirsiniz. Projeyi Hata Ayıklama Modunda çalıştırdığınızda Visual Studio Word veya Excel'i başlatır ve hata ayıklayıcı Word veya Excel'de aynı işlemde çalışan her şeyi ekler. Visual Studio hata ayıklama araçları hakkında daha fazla bilgi için, bkz. Visual Studio'da hata ayıklama.

İpucu
Derleme ve hata ayıklamadan önce çakışmalardan kaçınmak için tüm açık Word veya Excel örneklerini kapatır.

Uygulama alanı: Bu konudaki bilgiler şu uygulamaların belge düzeyi projelerine yöneliktir: Excel 2007 ve Excel 2010; Word 2007 ve Word 2010. 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?.

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. Daha fazla bilgi için bkz. Debugging Shortcut Keys, Brief Scheme.

Hata Ayıklamayı Durdurma

Bir belgede veya çalışma kitabında hata ayıklama başlattığı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ı Word veya Excel'i beklenmedik şekilde sonlandırır veya hata ayıklayıcıyı ayırmaya ayarladıysanız ayırır. Diğer tüm belgeler veya sonlandırılmış bir Word veya Excel işleme açılan çalışma kitaplarındaki uyarmadan da 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 Word ve Excel normal bir şekilde çıkabilirsiniz işleminden hata ayıklayıcı durdurmadan önce ayırmak daha iyidir. Siz yine de bir açık belge veya çalışma sayfası hata ayıklayıcı durdurduktan sonra işe de işleminden önce ayırabilirsiniz. Ayırma işlemi hakkında daha fazla bilgi için bkz: Nasıl Yapılır: Tüm ayırmak İşlemleri.

Yoğun hata ayıklama oturumları boyunca hata ayıklayıcıyı sürekli durdurmak ve Word'un aniden kapanmasına sebep olmak Normal şablonunun bozulmasına yol açar. 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.

Word Visual Studio'da Açık iken Normal Şablonunu Kilitler

Word Visual Studio'da açık iken varsayılan Normal şablonunu kilitler. Çözümünüzü hata ayıklama için çalıştırdığınızda Word'un bir kopyası başka bir işlemde açılır. Word'un açık olan kopyasına uygulama düzeyi özelleştirmelerini yaparsanız o değişiklikleri kaydedemezsiniz, çünkü Normal şablonu Visual Studio içinde açık olan işlem tarafından kilitlenmiştir.

Çalışma zamanında Word, belgelerin ayrı örneklerini tek bir işlemde açar, bu yüzden açık bir belge Normal şablonunu kilitleyecek ve uygulama düzeyi değişikliklerini engelleyecek değildir.

Daha fazla bilgi için, bkz. Bilgi Tabanı makalesi "PRB: Normal.dot When Word kullanarak bir Otomasyon sunucusu olarak kaydetmeden önce sor" (https://support.microsoft.com/default.aspx?scid=kb;en-us;285885).

Önbelleğe Alınmış Veri Kümelerinde 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ıldığı hakkında daha fazla bilgi için, bkz. Belgelere Güven İmtiyazı Verme.

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 depolar (<ProjeAdı>.vbproj.user veya <ProjeAdı>.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.

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.

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ü Günlük dosyasına belge veya özelleştirme ile ilişkili çalışma kitabını içeren klasörü oluşturur veya, başarısız, yerel % temp % klasörüne kopyalayın. Günlük dosyasının adı belge adı.uzantısıExcelWorkbook1.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: Office Projelerindeki Hataları İşleme

Kavramlar

Office Çözümleri Yapı İşlemine Genel Bakış

Diğer Kaynaklar

Visual Studio'da hata ayıklama

Office Çözümlerini Dağıtma

Office Çözümleri Tasarlama ve Oluşturma

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

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.