Debugowanie rozwiązań programu SharePoint
Rozwiązanie programu SharePoint można debugować za pomocą Visual Studio debugera.Podczas uruchamiania debugowania, Visual Studio wdraża pliki projektu do programu SharePoint server, a następnie otworzy wystąpienie witryny programu SharePoint w przeglądarce sieci Web.W poniższych sekcjach opisano sposób debugowania aplikacji programu SharePoint w Visual Studio.
Włączenie debugowania
Debugowanie F5 i procesu wdrażania
Funkcje programu SharePoint projektu
Debugowanie przepływy pracy
Odbiorniki zdarzenia funkcji debugowania
Włączenie rozszerzonych informacji o debugowaniu
Włączenie debugowania
Kiedy po raz pierwszy debug rozwiązanie programu SharePoint, w Visual Studio, okno dialogowe alert, że plik web.config nie jest skonfigurowany do włączenia tej funkcji.(Plik web.config jest tworzony podczas instalacji programu SharePoint server.Aby uzyskać więcej informacji, zobacz pracy z plikami Web.config.) Okno dialogowe daje możliwość albo uruchamianie projektu bez debugowania lub modyfikacji pliku web.config włączyć debugowanie.Jeśli wybierzesz opcję pierwszy, projekt działa normalnie.Jeśli wybierzesz drugą opcję, plik web.config jest skonfigurowany do:
Włącz stos wywołań (CallStack="true")
Wyłącz niestandardowe błędy w Visual Studio (<customErrors mode="Off" />)
Włącz debugowanie kompilacji (<compilation debug="true">)
Wynikowy plik web.config w następujący sposób:
<?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>
Aby odwrócić zmiany i wyłączyć debugowanie, należy zmienić następujące XML w pliku web.config:
Wyłącz stos wywołań (CallStack="false")
Włączanie niestandardowych błędów w Visual Studio (<customErrors mode="On" />)
Należy wyłączyć debugowanie kompilacji (<compilation debug="false">)
Debugowanie F5 i procesu wdrażania
Po uruchomieniu programu SharePoint projektu w trybie debugowania procesu wdrażania programu SharePoint wykonuje następujące zadania:
Uruchamia polecenia można dostosowywać przed wdrożeniem.
Tworzy plik pakietu (wsp) roztwór w sieci Web przy użyciu MSBuild polecenia.Plik wsp zawiera wszystkie potrzebne pliki i funkcje.Aby uzyskać więcej informacji, zobacz Rozwiązań Przegląd.
Jeśli rozwiązanie programu SharePoint jest rozwiązanie farmy, odtwarza IIS puli aplikacji dla określonej witryny URL.Ten krok zwalnia plików zablokowanych przez IIS proces roboczy.
Jeśli istnieje już poprzedniej wersji pakietu, cofa poprzednią wersję funkcji i plików w pliku wsp.W tym kroku wyłącza funkcje, odinstalowuje pakiet rozwiązania i usuwa pakiet rozwiązania na serwerze programu SharePoint.
Instaluje bieżącej wersji funkcji i plików w pliku wsp.W tym kroku dodaje i instaluje rozwiązanie na serwerze programu SharePoint.
Przepływy pracy instaluje się w zestawie przepływu pracy.Można zmienić jego lokalizację za pomocą Assembly Location właściwość.
Uaktywnia funkcję projektu w programie SharePoint, jeśli zakres znajduje się witryna lub w sieci Web.Funkcje w zakresach farmy i aplikacji sieci Web nie są aktywowane.
Dla przepływów pracy, przepływ pracy kojarzy z biblioteki programu SharePoint, listy lub witryny, który został wybrany w Kreatora dostosowania programu SharePoint.
[!UWAGA]
To skojarzenie występuje tylko wtedy, gdy wybrano automatycznie skojarzenie przepływu pracy w kreatorze.
Uruchamia można dostosowywać polecenia powdrożeniowe ze strony działu.
Dołącza Visual Studio debuger do Windows SharePoint Services procesów (w3wp.exe). Jeśli typ projektu pozwala na zmianę Sandboxed Solution właściwość i jej wartość jest ustawiona true, a następnie dołącza debugera do innego procesu (SPUCWorkerProcess.exe).Aby uzyskać więcej informacji, zobacz Względy roztwór trybie piaskownicy.
Uruchamia debuger JavaScript, jeśli rozwiązanie programu SharePoint jest rozwiązanie farmy.
Wyświetla odpowiednie biblioteki, listy lub strony w przeglądarce sieci Web.
Visual StudioWyświetla komunikat o stanie w oknie dane wyjściowe, po ukończeniu każdego zadania.Jeśli nie można ukończyć zadania, Visual Studio wyświetla komunikat o błędzie w oknie Lista błędów.
Funkcje programu SharePoint projektu
Funkcja jest przenośny i Modułowa jednostka funkcjonalność, co upraszcza modyfikacji witryn przy użyciu definicji witryny.Jest również pakiet Windows SharePoint Services (WSS) elementy, które można aktywować dla określonego zakresu i pomaga użytkownikom osiągnąć konkretny cel lub zadanie.Szablony są wdrażane jako funkcje.
Podczas projektu w trybie debugowania, proces wdrażania tworzy folder w funkcji katalog w %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES.Nazwy funkcji mają format Nazwa projektu_Featurex, takich jak TestProject_Feature1.
Zawiera rozwiązanie folder w katalogu funkcji w definicji funkcji plik i definicji przepływu pracy pliku.Plik definicji funkcji (Feature.xml) opisuje pliki w funkcji projektu.Plik definicji projektu (Elements.xml) zawiera opis szablonu projektu.Elements.XML można znaleźć w Solution Explorer, ale Feature.xml jest generowany podczas tworzenia pakietu rozwiązania.Aby uzyskać więcej informacji na temat tych plików, zobacz Projekt programu SharePoint i szablony element projektu.
Debugowanie przepływy pracy
Podczas debugowania projektów przepływu pracy, Visual Studio dodaje szablon przepływu pracy (w zależności od jego typu) do biblioteki lub listy.Następnie można uruchomić szablon przepływu pracy ręcznie lub przez dodanie lub aktualizowanie element.Następnie można użyć Visual Studio do debugowania przepływu pracy.
[!UWAGA]
Po dodaniu odwołania do innych zestawów, upewnij się, że tych zestawów zainstalowanych w globalna pamięć podręczna zestawów (GAC).W przeciwnym razie roztwór przepływu pracy nie powiedzie się.Aby uzyskać informacje dotyczące sposobu instalowania zestawów, zobacz ręcznie uruchomić przepływ pracy dla dokumentu lub elementu.
Jednak proces wdrożenia nie można uruchomić przepływu pracy.Z witryny sieci Web programu SharePoint, należy uruchomić przepływ pracy.Można również uruchomić przepływ pracy, korzystając z aplikacji klienckiej, takich jak Microsoft Office Word 2010 lub za pomocą osobnego kodu po stronie serwera.Użyj jednej z metod określonych w Kreatora dostosowania programu SharePoint.
Na przykład jeśli określono, że przepływ pracy można uruchomić ręcznie, należy uruchomić przepływ pracy bezpośrednio z element biblioteki lub listy.Aby uzyskać więcej informacji na temat sposobu ręcznego uruchamiania przepływu pracy, zobacz ręcznie uruchomić przepływ pracy dla elementu dokumentu.
Odbiorniki zdarzenia funkcji debugowania
Domyślnie po uruchomieniu Visual Studio aplikacji programu SharePoint, jego funkcje są automatycznie aktywowane dla Ciebie na serwerze programu SharePoint.Jednak to powoduje problemy podczas debugowania odbiorniki zdarzenia funkcji, ponieważ po uaktywnieniu funkcji przez Visual Studio, działa w innym procesie niż debugera.Oznacza to, że niektóre funkcje debugowania, takie jak punkty przerwania, nie będzie działać poprawnie.
Aby wyłączyć automatyczne włączanie funkcji w programie SharePoint i zezwalanie na debugowanie właściwego odbiorników zdarzeń funkcji, należy ustawić wartość projektu Konfiguracji wdrażania usługi Active właściwość, aby Nr Aktywacja przed debugowania.Następnie, po uruchomieniu debugowanie aplikacji programu SharePoint w Visual Studio, ręcznie uaktywnić funkcję w programie SharePoint.Aby uaktywnić funkcję, należy otworzyć Akcje witryny wybierz menu w programie SharePoint, Ustawienia witryny, wybierz Funkcji witryny zarządzania łącze, a następnie wybierz Aktywuj przycisk obok funkcji, kontynuowanie debugowania normalnie.
Włączenie rozszerzonych informacji o debugowaniu
Z powodu czasami złożonych wzajemnych zależności pomiędzy Visual Studio proces (devenv.exe), Visual Studio SharePoint host proces (vssphost4.exe), SharePoint i warstwy WCF diagnozowania błędów, które występują w trakcie budowania, wdrażania i tak dalej może być wyzwaniem.Aby wyeliminować takie błędy, można włączyć rozszerzone informacje debugowania.Aby to zrobić, przejdź do następującego klucza rejestru w rejestrze systemu Windows:
[HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools]
Jeśli "EnableDiagnostics" REG_DWORD wartość nie jest już nie istnieje, ręcznie utworzyć.Ustaw wartość "EnableDiagnostics" na "1".
Ustawienie tej wartości klucza na 1 powoduje, że stos śledzenia informacji w produkcji okna w każdym przypadku, gdy projekt systemu błędy występują podczas pracy Visual Studio.Aby wyłączyć rozszerzonych informacji o debugowaniu, zestaw EnableDiagnostics 0 lub usunąć wartość.
Aby uzyskać więcej informacji na temat innych kluczy rejestru programu SharePoint, zobacz Debugowanie rozszerzeń dla narzędzia programu SharePoint w programie Visual Studio.