Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Sie können SharePoint-Lösungen mithilfe des Visual Studio-Debuggers debuggen. Wenn Sie mit dem Debuggen beginnen, stellt Visual Studio die Projektdateien auf dem SharePoint-Server bereit und öffnet dann eine Instanz der SharePoint-Website im Webbrowser. In den folgenden Abschnitten wird erläutert, wie SharePoint-Anwendungen in Visual Studio gedebuggt werden.
Aktivieren des Debuggings
Wenn Sie eine SharePoint-Lösung in Visual Studio zum ersten Mal debuggen, werden Sie in einem Dialogfeld darüber informiert, dass die web.config Datei nicht zum Aktivieren des Debuggens konfiguriert ist. (Die web.config Datei wird erstellt, wenn Sie SharePoint-Server installieren. Weitere Informationen finden Sie unter Arbeiten mit Web.config Dateien.) Im Dialogfeld können Sie entweder das Projekt ohne Debuggen ausführen oder die web.config Datei ändern, um das Debuggen zu aktivieren. Wenn Sie die erste Option auswählen, wird das Projekt normal ausgeführt. Wenn Sie die zweite Option auswählen, wird die web.config Datei wie folgt konfiguriert:
Schalten Sie den Aufrufstapel ein (
CallStack="true")Deaktivieren von benutzerdefinierten Fehlern in Visual Studio (
<customErrors mode="Off" />)Kompilierungsdebugging aktivieren (
<compilation debug="true">)Die resultierende web.config Datei folgt:
<?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>
Um die Änderungen rückgängig zu machen und das Debuggen zu deaktivieren, ändern Sie den folgenden XML-Code in der web.config Datei:
Deaktivieren des Aufrufstapels (
CallStack="false")Aktivieren von benutzerdefinierten Fehlern in Visual Studio (
<customErrors mode="On" />)Kompilierungsdebugging deaktivieren (
<compilation debug="false">)
F5-Debug- und Bereitstellungsprozess
Wenn Sie Ihr SharePoint-Projekt im Debugmodus ausführen, führt der SharePoint-Bereitstellungsprozess die folgenden Aufgaben aus:
Führt die anpassbaren Befehle vor der Bereitstellung aus.
Erstellt eine Weblösungspaketdatei (WSP) mithilfe von MSBuild-Befehlen. Die WSP-Datei enthält alle erforderlichen Dateien und Features. Weitere Informationen finden Sie unter "Solutions Overview".
Wenn es sich bei der SharePoint-Lösung um eine Farmlösung handelt, wird der IIS-Anwendungspool für die angegebene Website-URL wiederverwendet. In diesem Schritt werden Dateien freigegeben, die vom IIS-Arbeitsprozess gesperrt sind.
Wenn bereits eine frühere Version des Pakets vorhanden ist, wird die vorherige Version der Features und Dateien in der WSP-Datei zurückgezogen. In diesem Schritt werden die Features deaktiviert, das Lösungspaket deinstalliert und anschließend das Lösungspaket auf dem SharePoint-Server gelöscht.
Installiert die aktuelle Version der Features und Dateien in der WSP-Datei. In diesem Schritt wird die Lösung auf dem SharePoint-Server hinzugefügt und installiert.
Für Workflows installieren Sie die Workflow-Assembly. Sie können den Speicherort ändern, indem Sie die Eigenschaft Assembly Location verwenden.
Aktiviert das Feature des Projekts in SharePoint, wenn der Bereich Website oder Web ist. Features in den Bereichen Farm und WebApplication werden nicht aktiviert.
Bei Workflows wird der Workflow mit der SharePoint-Bibliothek, -Liste oder -Website verknüpft, die Sie im Assistenten zum Anpassen von SharePoint ausgewählt haben.
Hinweis
Diese Zuordnung tritt nur auf, wenn Sie im Assistenten Workflow automatisch zuordnen ausgewählt haben.
Führt die anpassbaren Befehle nach der Bereitstellung aus.
Fügt den Visual Studio-Debugger an den Windows SharePoint Services-Prozess an (w3wp.exe). Wenn Sie mit dem Projekttyp die Eigenschaft "Sandkastenlösung " ändern können und der Wert auf "true" festgelegt ist, wird der Debugger einem anderen Prozess (SPUCWorkerProcess.exe) zugeordnet. Weitere Informationen finden Sie unter Überlegungen zur Sandkastenlösung.
Startet den JavaScript-Debugger, wenn die SharePoint-Lösung eine Farmlösung ist.
Zeigt die entsprechende Bibliotheks-, Listen- oder Websiteseite im Webbrowser an.
Visual Studio zeigt eine Statusmeldung im Ausgabefenster an, nachdem jede Aufgabe abgeschlossen wurde. Wenn eine Aufgabe nicht abgeschlossen werden kann, zeigt Visual Studio eine Fehlermeldung im Fenster "Fehlerliste" an.
SharePoint-Projektfeatures
Ein Feature ist eine tragbare und modulare Funktionalitätseinheit, die die Änderung von Websites mithilfe von Websitedefinitionen vereinfacht. Es handelt sich auch um ein Paket von Windows SharePoint Services (WSS)-Elementen, die für einen bestimmten Bereich aktiviert werden können und benutzern dabei helfen, ein bestimmtes Ziel oder eine bestimmte Aufgabe zu erreichen. Vorlagen werden als Features bereitgestellt.
Wenn Sie ein Projekt im Debugmodus ausführen, erstellt der Bereitstellungsprozess einen Ordner im Featureverzeichnis unter %COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\14\TEMPLATE\FEATURES. Featurenamen haben das Format Projektname_Featurex, z. B. TestProject_Feature1.
Der Ordner der Lösung im Featureverzeichnis enthält eine Featuredefinitionsdatei und eine Workflowdefinitionsdatei . Die Featuredefinitionsdatei (Feature.xml) beschreibt die Dateien im Feature des Projekts.Die Projektdefinitionsdatei (Elements.xml) beschreibt die Projektvorlage. Elements.xml finden Sie im Projektmappen-Explorer, aber Feature.xml wird generiert, wenn das Lösungspaket erstellt wird. Weitere Informationen zu diesen Dateien finden Sie unter SharePoint-Projekt- und Projektelementvorlagen.
Debuggen von Workflows
Wenn Sie Workflowprojekte debuggen, fügt Visual Studio der Bibliothek oder einer Liste die Workflowvorlage (je nach Typ) hinzu. Anschließend können Sie die Workflowvorlage manuell starten oder ein Element hinzufügen oder aktualisieren. Anschließend können Sie Visual Studio verwenden, um den Workflow zu debuggen.
Hinweis
Wenn Sie Verweise auf andere Assemblys hinzufügen, stellen Sie sicher, dass diese Assemblys im globalen Assemblycache (GAC) installiert sind. Andernfalls schlägt die Workflowlösung fehl. Informationen zum Installieren von Assemblys finden Sie unter Manuelles Starten eines Workflows für ein Dokument oder Element.
Der Bereitstellungsprozess startet den Workflow jedoch nicht. Sie müssen den Workflow von der SharePoint-Website starten. Sie können den Workflow auch mithilfe einer Clientanwendung wie Microsoft Office Word 2010 oder mit separatem serverseitigem Code starten. Verwenden Sie einen der im Assistenten zum Anpassen von SharePoint angegebenen Ansätze.
Wenn Sie beispielsweise angegeben haben, dass der Workflow manuell gestartet werden kann, starten Sie den Workflow direkt aus dem Element in der Bibliothek oder Liste. Weitere Informationen zum manuellen Starten eines Workflows finden Sie unter Manuelles Starten eines Workflows für ein Dokumentelement.
Debuggen von Featureereignisempfängern
Wenn Sie eine Visual Studio-SharePoint-Anwendung ausführen, werden die zugehörigen Features standardmäßig automatisch auf dem SharePoint-Server aktiviert. Dies verursacht jedoch Probleme beim Debuggen von Featureereignisempfängern, da ein Feature, das von Visual Studio aktiviert wird, in einem anderen Prozess als der Debugger ausgeführt wird. Dies bedeutet, dass einige Debugfunktionen, z. B. Haltepunkte, nicht ordnungsgemäß funktionieren.
Um die automatische Aktivierung des Features in SharePoint zu deaktivieren und das ordnungsgemäße Debuggen von Featureereignisempfängern zuzulassen, legen Sie den Wert der Active Deployment Configuration-Eigenschaft des Projekts auf "Keine Aktivierung" vor dem Debuggen fest. Nachdem Sie mit dem Debuggen Ihrer SharePoint-Anwendung in Visual Studio begonnen haben, aktivieren Sie das Feature in SharePoint manuell. Um das Feature zu aktivieren, öffnen Sie das Menü "Websiteaktionen " in SharePoint, wählen Sie " Websiteeinstellungen" aus, wählen Sie den Link " Websitefeatures verwalten " und dann die Schaltfläche " Aktivieren" neben dem Feature aus, um das Debuggen wie gewohnt fortzusetzen.
Erweiterte Debuginformationen aktivieren
Aufgrund der manchmal komplexen Interaktionen zwischen dem Visual Studio-Prozess (devenv.exe), dem Visual Studio SharePoint-Hostprozess (vssphost4.exe), SharePoint und der WCF-Ebene kann es eine Herausforderung sein, Fehler zu diagnostizieren, die beim Erstellen, Bereitstellen und anderen Vorgängen auftreten. Um diese Fehler zu beheben, können Sie erweiterte Debuginformationen aktivieren. Wechseln Sie hierzu zum folgenden Registrierungsschlüssel in der Windows-Registrierung:
HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools
Wenn der Wert "EnableDiagnostics" REG_DWORD noch nicht vorhanden ist, erstellen Sie ihn manuell. Legen Sie den Wert "EnableDiagnostics" auf "1" fest.
Wenn Sie diesen Schlüsselwert auf 1 festlegen, erscheinen Stapelablaufverfolgungsinformationen im Ausgabefenster, immer wenn Fehler des Projektsystems auftreten, während Visual Studio ausgeführt wird. Um erweiterte Debuginformationen zu deaktivieren, legen Sie EnableDiagnostics auf 0 fest, oder löschen Sie den Wert.
Weitere Informationen zu anderen SharePoint-Registrierungsschlüsseln finden Sie unter Debugerweiterungen für die SharePoint-Tools in Visual Studio.