Ladění řešení služby SharePoint
Řešení služby SharePoint lze ladit pomocí Visual Studio ladicí program.Při spuštění ladění, Visual Studio instaluje soubory projektu na server SharePoint a potom otevře instance webu služby SharePoint ve webovém prohlížeči.Následující části popisují, jak ladit aplikace SharePoint v Visual Studio.
Povolení ladění
F5 ladění a zavádění
Funkce projektu SharePoint
Ladění pracovních postupů
Ladění přijímačů událostí funkce
Povolení rozšířené informace o ladění
Povolení ladění
Při prvním ladění řešení služby SharePoint v Visual Studio, dialogové okno upozornění, že není nakonfigurován v souboru web.config povolit ladění.(Soubor web.config je vytvořena při instalaci serveru SharePoint.Další informace naleznete v Práce se soubory Web.config.) Dialogovém okně dává možnost buď spuštěn projekt bez ladění nebo úprava souboru web.config povolit ladění.Pokud zvolíte první možnost, projekt běží normálně.Pokud zvolíte druhou možnost, je nakonfigurován v souboru web.config na:
Zapnout zásobníku volání (CallStack="true")
Zakázat vlastní chyby v Visual Studio (<customErrors mode="Off" />)
Povolit ladění kompilace (<compilation debug="true">)
Výsledný soubor web.config takto:
<?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>
Změny a zakázat ladění, změňte následující XML v souboru web.config:
Vypnutí zásobníku volání (CallStack="false")
Povolit vlastní chyby v Visual Studio (<customErrors mode="On" />)
Zakázat ladění kompilace (<compilation debug="false">)
F5 ladění a zavádění
Při spuštění projektu SharePoint v režimu ladění procesu nasazení služby SharePoint provádí následující úlohy:
Spustí příkazy před zavedením přizpůsobitelné.
Vytvoří soubor balíčku (WSP) webové řešení pomocí MSBuild příkazy.Soubor WSP obsahuje všechny potřebné soubory a funkce.Další informace naleznete v Přehled řešení.
Pokud je řešení SharePoint řešení farmy, recykluje IIS fond aplikací pro zadaný server URL.Tento krok uvolní soubory uzamčeny IIS pracovní proces.
Pokud již existuje předchozí verzi balíčku, procházející předchozí verze souborů do souboru WSP a funkce.Tento krok deaktivuje funkce odinstaluje balíček řešení a pak odstraní balíček řešení na serveru SharePoint.
Aktuální verze souborů a funkce nainstaluje soubor WSP.Tento krok přidá a nainstaluje řešení na serveru SharePoint.
Pracovní postupy nainstaluje sestavení pracovního postupu.Pomocí můžete změnit jeho umístění Assembly Location vlastnost.
Pokud je obor webu nebo webové, aktivuje funkci projektu služby SharePoint.Funkce v hospodářství a WebApplication obory nejsou aktivovány.
Pro pracovní postupy, přidruží pracovní knihovny SharePoint, seznamu nebo webu, který jste vybrali SharePoint přizpůsobení průvodce.
[!POZNÁMKA]
Toto přidružení dochází, pouze pokud jste vybrali automaticky přiřadit pracovní v průvodci.
Spustí příkazy přizpůsobitelné post-deployment.
Připojí Visual Studio ladicí program, aby Windows SharePoint Services proces (w3wp.exe). Pokud je typ projektu umožňuje změnit Sandboxed Solution je nastavena vlastnost a její hodnotu na true, potom připojí ladicí program (SPUCWorkerProcess.exe) do jiného procesu.Další informace naleznete v tématu Uzavřených apletů aspekty řešení.
Pokud je řešení SharePoint řešení farmy, spustí JavaScript debugger.
Zobrazí příslušnou knihovnu, seznam nebo stránku ve webovém prohlížeči.
Visual StudioPo dokončení každého úkolu, zobrazí stav zprávy v okně Výstup.Pokud úkol nemůže být dokončena, Visual Studio zobrazí chybová zpráva v okně seznamu chyb.
Funkce projektu SharePoint
Funkce je přenosný a modulární jednotka funkce zjednodušující modifikace weby pomocí definice webu.Je také balíček Windows SharePoint Services prvky (WSS) může být aktivována pro konkrétní obor a které pomáhají uživatelům dosáhnout určitého cíle nebo úkol.Šablony jsou nasazeny jako funkce.
Při spuštění projektu v režimu ladění procesu nasazení vytvoří složku funkce adresáře na %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES.Názvy funkcí mají formát název projektu_Featurex, například TestProject_Feature1.
Obsahuje složku řešení v adresáři funkce definice funkce souboru a definice pracovního postupu souboru.Soubor definice funkce (souboru funkce.XML) popisuje soubory v projektu funkce.Soubor definice projektu (Elements.xml) popisuje šablony projektu.Elements.XML lze nalézt v Průzkumníku, ale souboru funkce.XML je generován při vytvoření balíčku řešení.Další informace o těchto souborech naleznete Projekt SharePoint a šablony položek projektu.
Ladění pracovních postupů
Při ladění projekty pracovního postupu Visual Studio přidá šablonu pracovního postupu (v závislosti na jeho typu) do knihovny nebo seznamu.Šablona pracovního postupu potom můžete spustit ručně nebo pomocí přidání nebo aktualizaci položky.Můžete použít Visual Studio ladění pracovního postupu.
[!POZNÁMKA]
Pokud chcete přidat odkazy na jiné sestavení, ujistěte se, že tyto sestavení nainstalovaných v globální mezipaměť sestavení (GAC) (GAC).Jinak se nezdaří řešení pracovního postupu.Informace o instalaci sestavení naleznete v tématu Ruční spuštění pracovního postupu pro dokument nebo položku.
Proces nasazení nespustí pracovního postupu.Pracovní postup je nutné spustit z webu služby SharePoint.Pracovní postup můžete spustit také pomocí klienta aplikace, například Microsoft Office Word 2010, nebo pomocí samostatného kódu na straně serveru.Použijte jeden z přístupů v SharePoint přizpůsobení průvodce.
Pokud jste určili, že je ruční spuštění pracovního postupu, například spustíte pracovní postup přímo z položky v seznamu nebo knihovně.Další informace o ruční spuštění pracovního postupu, viz Ruční spuštění pracovního postupu u položky dokumentu.
Ladění přijímačů událostí funkce
Ve výchozím nastavení při spuštění Visual Studio aplikace SharePoint, jeho funkce jsou automaticky aktivovány můžete na serveru SharePoint.Však dojde k potížím při ladění funkce přijímačů událostí, protože při aktivaci funkce podle Visual Studio, spustí jiný proces než ladicí program.To znamená, že nebudou správně fungovat některé funkce ladění, například zarážky.
Zakázat automatické aktivace funkce služby SharePoint a umožnit správné ladění funkce přijímačů událostí, nastavte hodnotu na projekt Aktivní konfigurace nasazení vlastnost Aktivace č před ladění.Potom po spuštění ladění aplikace SharePoint v Visual Studio, ručně aktivovat funkci ve službě SharePoint.Aktivovat funkci, otevřete Akce webu nabídky ve službě SharePoint, zvolte Nastavení webu, zvolte Spravovat funkce webu odkaz a pak zvolte aktivovat tlačítko vedle funkce pokračujte jako normální.
Povolení rozšířené informace o ladění
Protože někdy složité interakce mezi Visual Studio procesu (devenv.exe) Visual Studio SharePoint hostitelem proces (vssphost4.exe), SharePoint a vrstva WCF diagnostikování chyby, které se vyskytnou při vytváření, zavádění a podobně může být složité.K řešení takových chyb můžete povolit rozšířené informace o ladění.Provedete to tak, přejděte na následující klíč registru v registru systému Windows:
[HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools]
Pokud "EnableDiagnostics" REG_DWORD hodnota ještě neexistuje, vytvořit ručně.Nastavte hodnotu "EnableDiagnostics" 1."
Informace v zásobníku 1 způsobí nastavení tohoto klíče hodnotu trasování výstup okno při výskytu chyby systému projektu v době spuštění Visual Studio.Zakázat rozšířené informace o ladění, EnableDiagnostics zpět na hodnotu 0 nebo hodnotu odstraňte.
Další informace o jiných klíčích registru SharePoint naleznete v Ladění rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio.