Hata ayıklama SharePoint çözümleri
SharePoint çözümlerini kullanarak debug Visual Studio hata ayıklayıcı.Hata ayıklamayı başlattığınızda Visual Studio SharePoint server proje dosyalarını dağıtır ve SharePoint sitesi örneği Web tarayıcısında açılır.Aşağıdaki bölümlerde, SharePoint uygulamalarında hata ayıklamak anlatan Visual Studio.
Hata ayıklamayı etkinleştirme
F5 hata ayıklama ve dağıtım işlemi
SharePoint proje özellikleri
Hata ayıklama iş akışları
Hata ayıklama özelliği olay alıcıları
Gelişmiş hata ayıklama bilgilerini etkinleştirme
Hata ayıklamayı etkinleştirme
Ne zaman, ilk debug SharePoint çözüm içinde Visual Studio, web.config dosyasında hata ayıklamayı etkinleştirmek için yapılandırılmamış uyarıları iletişim kutusu.(SharePoint server'ı yüklediğinizde, web.config dosyası oluşturulur.Daha fazla bilgi için bkz: Web.config dosyaları ile çalışma.) İletişim kutusu hata ayıklamayı etkinleştirmek için ya da projenin hata ayıklama veya web.config dosyasını değiştirme çalıştırma seçeneğini verir.İlk seçeneği seçerseniz, projeyi normal olarak çalışır.İkinci seçeneği seçerseniz, için web.config dosyasında yapılandırılır:
Çağrı yığını üzerinde kapatma (CallStack="true")
Özel hatalar devre dışı Visual Studio (<customErrors mode="Off" />)
Derleme hata ayıklamayı etkinleştir (<compilation debug="true">)
Ortaya çıkan web.config dosyası aşağıdaki gibidir:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<configuration>
...
<SharePoint>
<SafeMode MaxControls="200"
CallStack="true"
DirectFileDependencies="10"
TotalFileDependencies="50"
AllowPageLevelTrace="false">
...
</SafeMode>
...
</SharePoint>
<system.web>
...
<customErrors mode="Off" />
...
<compilation debug="true">
...
</compilation>
...
</system.web>
...
</configuration>
Değişikliklerinizi geri ve hata ayıklamayı devre dışı bırakmak için aşağıdaki değiştirin XML web.config dosyasında:
Çağrı yığını devre dışı bırakmak (CallStack="false")
Özel hatalar etkinleştirmek Visual Studio (<customErrors mode="On" />)
Derleme hata ayıklamasını devreden çıkar (<compilation debug="false">)
F5 hata ayıklama ve dağıtım işlemi
SharePoint dağıtım işlemini SharePoint projenizi hata ayıklama modunda çalıştırdığınızda, aşağıdaki görevleri gerçekleştirir:
Özelleştirilebilir önceden dağıtım komutları çalıştırır.
Web çözüm paketi (.wsp) dosyası kullanarak oluşturur MSBuild komutları..Wsp dosyası tüm gerekli dosyaları ve özellikleri içerir.Daha fazla bilgi için bkz: Solutions genel bakış.
Grup çözümü SharePoint çözüm ise, geri dönüştürür IIS belirtilen sitesi için uygulama havuzu URL.Bu adımı tarafından kilitlenmiş dosyaları yayımlamaktadır IIS alt işlem.
Paketinin önceki bir sürümü zaten varsa, özellikleri ve .wsp dosyası dosyaların önceki sürümünü geri çeker.Bu adımı özellikleri devre dışı bırakır, çözüm paketi kaldırır ve çözüm paketi SharePoint Server'da siler.
Dosya özellikleri ve geçerli sürümünü .wsp dosyası yükler.Bu adımı ekler ve çözüm SharePoint sunucusu yükler.
İş akışları için iş akışı derleme yükler.Konumunu kullanarak değiştirme Assembly Location özelliği.
Site veya Web kapsamındaysa SharePoint Proje özelliğini etkinleştirir.Çiftlik ve WebApplication kapsamlarda özellikleri etkinleştirilmedi.
İş akışları için iş akışı SharePoint kitaplığı, listesi veya seçtiğiniz site ilişkilendirir SharePoint Özelleştirme Sihirbazı'nı.
[!NOT]
Bu ilişki yalnızca seçtiğiniz ortaya otomatik olarak iş akışı ilişkilendirme Sihirbazı'nda.
Özelleştirilebilir sonrası komutları çalıştırır.
Ekler Visual Studio için hata ayıklayıcı, Windows SharePoint Services işleminin (w3wp.exe). Proje tipini değiştirmenizi sağlar, Sandboxed Solution özelliği ve değeri ayarlandığında true, sonra da farklı bir işlem (SPUCWorkerProcess.exe) hata ayıklayıcı ekler.Daha fazla bilgi için bkz. Kutulu çözüm hakkında önemli noktalar.
Grup çözümü SharePoint çözüm ise, JavaScript hata ayıklayıcıyı başlatır.
Uygun kitaplık, liste veya site sayfası Web tarayıcısında görüntüler.
Visual Studioher görev tamamlandıktan sonra çıktı penceresinde durum iletisini görüntüler.Bir görev tamamlandı, Visual Studio Hata Listesi penceresinde bir hata iletisi görüntüler.
SharePoint proje özellikleri
Bir özelliği site tanımlarını kullanarak siteleri değiştirilmesini basitleştirir. işlevsellik taşınabilir ve modüler bir birimdir.Ayrıca paketi olan Windows SharePoint Services (wss) öğeleri, etkinleştirilmiş olmalı için belirli bir kapsam ve kullanıcıların belirli hedef veya görevi gerçekleştirmenize yardımcı olur.Şablon Özellikleri dağıtılır.
Bir projenin hata ayıklama modunda çalıştırdığınızda, dağıtım işlemi bir klasörde oluşturur özelliği dizin konumunda %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES.Özellik adları biçimi olan Proje adı_Featurex, TestProject_Feature1 gibi.
Çözümün klasöründe özelliği dizin içeren bir özellik tanımı dosya ve bir iş akışı tanımını dosyası.Özellik tanım dosyası (Feature.XML dosyasına) dosyaları proje özelliği anlatılmaktadır.Proje şablonu proje tanım dosyası (Elements.xml) açıklar.Elements.XML bulunabilir Çözüm Gezgini, ancak Feature.XML dosyasına çözüm paketi oluşturulduğunda oluşturulur.Bu dosyalar hakkında daha fazla bilgi için bkz: SharePoint proje ve proje madde şablonları.
Hata ayıklama iş akışları
İş akışı projeleri, hata ayıklama, Visual Studio (kendi türüne) iş akışı şablonu kitaplığı ya da listesine ekler.İş akışı şablonu el ile ekleme veya güncelleştirme öğe sonra başlatabilirsiniz.Daha sonra Visual Studio iş akışı hata ayıklamak için.
[!NOT]
Diğer derlemelere başvuruları ekleyin, emin olun, bu derlemeleri genel bütünleştirilmiş kod önbelleğinde yüklü (GAC).Aksi takdirde iş akışı çözüm başarısız olur.Derlemeleri yükleme hakkında daha fazla bilgi için bkz: bir belge veya öğe üzerindeki iş akışını el ile başlatmak.
Ancak, dağıtım işlemi iş akışı başlatılamıyor.İş akışı SharePoint Web sitesinden başlatmanız gerekir.İş akışı, ayrı bir sunucu tarafı kod kullanarak veya Microsoft Office Word 2010 gibi bir istemci uygulamasını kullanarak da başlatabilirsiniz.Belirtilen yaklaşımdan birini kullanmak SharePoint Özelleştirme Sihirbazı'nı.
Örneğin, iş akışı elle başlatılabilir belirttiyseniz, kitaplıkta veya liste öğesinden doğrudan iş akışı başlatın.Bir iş akışını el ile başlatma hakkında daha fazla bilgi için bkz: el ile bir belge öğesi üzerinde bir iş akışı başlatmak.
Hata ayıklama özelliği olay alıcıları
Çalıştırdığınızda varsayılan olarak, bir Visual Studio SharePoint uygulama özellikleri otomatik olarak sizin için SharePoint sunucusunda etkinleştirilir.Olay alıcıları özelliği, hata ayıklama sırasında bir özellik tarafından etkinleştirildiğinde çünkü ancak, bu soruna neden Visual Studio, hata ayıklayıcı'yı farklı bir işlemde çalıştırır.Buna göre kesme gibi bazı hata ayıklama işlevi düzgün çalışmaz.
SharePoint özelliği otomatik etkinleştirmeyi devre dışı bırakın ve uygun özellik olay alıcıları hata ayıklamaya izin verme için projenin değerini Etkin dağıtım yapılandırması özelliğini No etkinleştirme önce hata ayıklama.Daha sonra SharePoint uygulamanızda hata ayıklama başlattıktan sonra Visual Studio, el ile etkinleştirmek için SharePoint özelliği.Özelliğini etkinleştirmek için açık Site eylemleri SharePoint, menüde seçin Site Ayarları, seçin Site özelliklerini yönetmek bağlayın ve sonra Etkinleştir hata ayıklama normal olarak devam etmek için özelliğin yanındaki düğme.
Gelişmiş hata ayıklama bilgilerini etkinleştirme
Bazen karmaşık arasındaki etkileşimler nedeniyle Visual Studio işlem (devenv.exe) Visual Studio SharePoint barındıran işlem (vssphost4.exe), SharePoint ve wcf katman zor diğerleri olabilir ve dağıtma, oluşturma sırasında oluşan hataları tanılamak.Bu tür hataları gidermek yardımcı olmak için Gelişmiş hata ayıklama bilgilerini etkinleştirebilirsiniz.Bunu yapmak için Windows Kayıt Defteri'nde aşağıdaki kayıt defteri anahtarına gidin:
[HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools]
Yoksa "EnableDiagnostics" REG_DWORD değer zaten varsa, el ile oluşturun."EnableDiagnostics" değerini "1"
Bu anahtar değeri 1 nedenleri yığınına ayarlama görünmesi için bilgi izleme Çıkış çalışırken, proje sistem hataları oluştuğu zamanlarda pencere Visual Studio.Gelişmiş hata ayıklama bilgilerini devre dışı bırakmak için EnableDiagnostics 0 olarak ayarlayın veya değeri silin.
Diğer SharePoint kayıt defteri anahtarları hakkında daha fazla bilgi için bkz: Visual Studio SharePoint Araçlar için hata ayıklama uzantıları.