Visual Studio SharePoint Araçlar için hata ayıklama uzantıları

Deneysel örneği veya normal örnek Visual Studio uzantılarında SharePoint Araçları ayıklayabilirsiniz.Bir uzantı davranışı sorun gidermeniz gerekiyorsa, ek hata bilgilerini görüntülemek ve nasıl Visual Studio SharePoint komutları yürütür yapılandırmak için kayıt defteri değerlerini de değiştirebilirsiniz.

Visual Studio'nun deneysel örneği uzantılarında hata ayıklama

Visual Studio geliştirme ortamından yanlışlıkla Bozulması tarafından sınanmamış uzantıları korumak için Visual Studio sdk denilen alternatif bir Visual Studio örneği sağlar deneysel örneği, yüklemek ve uzantıları sınamak için kullanabilirsiniz.Visual Studio'nun normal örneği kullanarak yeni uzantılar geliştirmek, ancak hata ayıklama ve deneysel örneği çalıştırabilirsiniz.Daha fazla bilgi için bkz. Visual Studio Deneysel örneği.

Bir VSIX projesine uzantınızı dağıtmak için kullanın ve çözümünüzdeki başlangıç projesi VSIX projesi ise, Visual Studio otomatik olarak yükler ve çözümünüzün hatalarını ayıklayın uzantısı deneysel örneği çalıştırır.Başlangıç projesi birden fazla proje içeren bir çözüm debug başlatan bir projedir.Bir VSIX projesi kullanarak uzantı dağıtma hakkında daha fazla bilgi için bkz: Visual Studio SharePoint Araçlar için uzantıları dağıtma.Baþlangýç projeleri hakkında daha fazla bilgi için bkz: [NIB] 12/13 Nasıl yapılır: Başlangıç Projesi Seçme.

Çeşitli Visual Studio'nun deneysel örneği uzantılarında hata ayıklama nasıl gösteren örnekler için aşağıdaki talimatlara bakın:

• İzlenecek yol: SharePoint proje öğesi türü genişletme

• İzlenecek yol: Bölüm 1 bir öğe şablonu ile bir özel eylem proje öğesi oluşturma

• Adım adım işlem aşamaları: SharePoint projeler için özel dağıtım adım oluşturma

• İzlenecek yol: Server Explorer'da görünen Web bölümlerini genişletme

• İzlenecek yol: Server Explorer uzantısı SharePoint istemci nesne modelinde halinde arama

Normal örnek Visual Studio uzantılarında hata ayıklama

İlk uzantı projeniz Visual Studio'nun normal örneğinde hata ayıklamak istiyorsanız, normal örneğinde uzantısını yükleyin.Daha sonra ikinci bir Visual Studio işleme hata ayıklayıcı iliştirin.Bittikten sonra geliştirme bilgisayarında artık yükler böylece uzantıyı kaldırabilirsiniz.

Uzantıyı yüklemek için

1. Visual Studio tüm örneklerini kapatın.

2. Çift veya kısayol menüsünü açarak ve sonra seçme .vsix dosya uzantısı projenin yapı çıktı klasörüne açmak açık:

3. İçinde Visual Studio uzantı yükleyicisi iletişim kutusunda, Visual Studio uzantısı yüklemek ve daha sonra istediğiniz sürümü seçin Yükleme düğmesi.

   Visual Studio için %UserProfile%\AppData\Local\Microsoft\VisualStudio\11.0\Extensions\ uzantılı dosyaları yüklerYazar adı\uzantı adı\sürüm.Gelen bu yoldaki son üç klasör oluşturulur Author, Name, ve Version öğelerin extension.vsixmanifest dosya uzantısı için.

4. Visual Studio uzantı yükler sonra tercih Kapat düğmesi.

Uzantı hata ayıklamak için

1. Visual Studio yönetici ayrıcalıklarıyla başlatmaya ve uzantı projesini açın.Aşağıdaki adımlar bu örneği Visual Studio bakın ilk örneği.

2. Yönetici ayrıcalıklarıyla başka bir Visual Studio örneği başlatın.Aşağıdaki adımlar bu örneği Visual Studio bakın ikinci.

3. Visual Studio ilk örneğine dönün.

4. Menü çubuğunda Seç Debug, İşleme Ekle.

5. İçinde Kullanılabilir işlemler listesinde, devenv.exe seçin.Visual Studio ikinci kopyası için bu girdiyi gösterir; Proje uzantınızı hata ayıklamak istediğiniz örneğidir.

6. Seçim Attach düğmesi.

   Visual Studio Uzantı projesi, hata ayıklama modunda çalışır.

7. Visual Studio ikinci örneğine dönün.

8. Uzantınızı yükleyen yeni bir SharePoint projesi oluşturun.Örneğin, liste tanım proje öğeler için uzantı hata ayıklaması yapıyorsanız, oluşturun bir Liste tanımını proje.

9. Uzantısı kodunuzu test etmek için gerekli tüm adımları gerçekleştirin.

10. Uzantı hata ayıklamayı tamamladığınızda, Visual Studio ikinci bir örneğini kapatın.

Uzantıyı kaldırmak için

1. Visual Studio'da menü çubuğunda Seç araçları, uzantıları ve güncelleştirmeleri.

   Uzantıları ve güncelleştirmeleri iletişim kutusunu açar.

2. Uzantılar listesinde uzantısının adını seçin ve sonra seçin kaldırma düğmesi.

3. Görüntülenen iletişim kutusunda seçtiğiniz Evet uzantıyı kaldırmak istediğinizi onaylamak için düğme.

4. Seçim Şimdi yeniden kaldırma işlemi tamamlamak için düğme.

Hata ayıklama SharePoint komutları

SharePoint Araçları uzantısı'nın parçası olan bir SharePoint komutu hata ayıklamak istiyorsanız, vssphost4.exe işleme hata ayıklayıcı eklemeniz gerekir.SharePoint komutları yürütür 64-bit ana bilgisayar işlemidir.SharePoint komutları ve vssphost4.exe hakkında daha fazla bilgi için bkz: SharePoint nesne modelleri içine arama.

Vssphost4.exe işlem için hata ayıklayıcıyı eklemek

1. Yukarıdaki yönergeleri izleyerek Uzantınızı Visual Studio'nun deneysel örneği veya normal örnek Visual Studio hata ayıklamayı Başlat

2. Visual Studio içinde çalıştırmakta olduğunuz hata ayıklayıcı menü çubuğunda örneğini seçin Debug, İşleme Ekle.

3. İçinde Kullanılabilir işlemler listesinde, vssphost.exe seçin.

   [!NOT]

   Vssphost.exe listede görünmüyorsa, Visual Studio uzantısı çalıştırdığınız örneği vssphost4.exe işlemini başlatmanız gerekir.Tipik olarak, Visual Studio geliştirme bilgisayarında SharePoint sitesine bağlanmak neden olan eylemi gerçekleştirerek bunu.Altında bir site bağlantı düğümü (site URL'sini görüntüleyen bir düğümü)'ı genişletin, Visual Studio vssphost4.exe başlar SharePoint bağlantıları düğümünde Server Explorer penceresinde veya eklediğinizde, bazı SharePoint proje öğeleri gibi Listesi örneği veya Olay alıcısı SharePoint projesine öğeler.

4. Seçim Attach düğmesi.

5. Ayıklanacak Visual Studio örneğini komutu yürütmek için gereken adımları gerçekleştirin.

Hata ayıklama araçları uzantılarını SharePoint yardımcı olmak için kayıt defteri değerlerini değiştirme

SharePoint Araçları Visual Studio uzantısı ayıkladığınızda uzantısı gidermek için kayıt defteri değerlerini değiştirebilirsiniz.HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools anahtarı altındaki değerleri yok.Bu değerler, varsayılan olarak bulunmaz.

SharePoint Araçları herhangi bir uzantısı giderilmesine yardımcı olması için oluşturabilir ve EnableDiagnostics değerini ayarlayın.Bu değeri aşağıdaki tabloda açıklanmaktadır.

Value

Tanımlama

EnableDiagnostics

İçinde tanı iletilerinin görüntülenip görüntülenmeyeceğini belirtir reg_dword Çıkış pencere. Tanı iletileri görüntülemek için bu değeri 1 olarak ayarlayın.İletileri görüntülemeyi durdurmak için bu değeri 0 olarak ayarlayın veya bu değeri silin. İletileri yazmak için Çıkış uzantısı bir SharePoint penceresinden Araçlar, SharePoint proje hizmeti kullanın.Daha fazla bilgi için bkz. SharePoint proje hizmeti kullanma.

Uzantınız SharePoint komutu içeriyorsa, oluşturun ve komut giderme amacıyla ek değerleri ayarlayın.Bu değerler aşağıdaki tabloda açıklanmaktadır.

Value	Tanımlama
AttachDebuggerToHostProcess	reg_dword başladıktan hemen sonra vssphost4.exe için hata ayıklayıcıyı eklemek sağlayan bir iletişim kutusu görüntülenip görüntülenmeyeceğini belirtir.Bu başlatıldıktan hemen sonra hata ayıklamak istediğiniz komut vssphost.exe tarafından yürütülen kullanışlıdır ve hata ayıklayıcı komutu yürütülmeden önce el ile eklemek için yeterli zaman değil.İletişim kutusunda, vssphost4.exe çağrıları görüntülemek için Debugger.Break yöntemi başlatıldığında. Bu davranışı etkinleştirmek için bu değeri 1 olarak ayarlayın.Bu davranışı devre dışı bırakmak için bu değeri 0 olarak ayarlayın veya bu değeri silin. Bu değeri 1 olarak ayarlarsanız, kendinizi Visual Studio vssphost4.exe başarıyla başlatıldı sinyal bekler önce hata ayıklayıcıyı eklemek yeterli zamanı vermek için HostProcessStartupTimeout değerini arttırmak isteyebilirsiniz.
ChannelOperationTimeout	reg_dword zaman Visual Studio bir SharePoint komutun yürütülmesi için bekleyeceği saniye cinsinden belirtir.Komutu yürütmek zaman içinde bir SharePointConnectionException atılır. Varsayılan değer 120 saniyedir.
HostProcessStartupTimeout	Visual Studio, sinyal vssphost4.exe için bekleyeceği, saniye cinsinden süreyi belirtir reg_dword başarıyla başlatıldı.Vssphost4.exe zaman içinde başarılı bir başlangıç sinyali değil, bir SharePointConnectionException atılır. Varsayılan değer 60 saniyedir.
MaxReceivedMessageSize	reg_dword izin verilen boyut üst sınırını, Visual Studio ile vssphost4.exe arasında geçirilen wcf iletileri bayt cinsinden belirtir. 1.048.576 Bayt (1 mb) varsayılandır.
MaxStringContentLength	reg_dword izin verilen boyut üst sınırını, Visual Studio ile vssphost4.exe arasında geçirilen dizeleri bayt cinsinden belirtir. 1.048.576 Bayt (1 mb) varsayılandır.

Ayrıca bkz.

Kavramlar

Visual Studio SharePoint Araçlar için uzantıları dağıtma

Diğer Kaynaklar

Visual Studio SharePoint araçları genişletme