Problembehandlung bei SharePoint-Lösungen

Die folgenden Probleme oder Warnungen können auftreten, wenn SharePoint-Lösungen mithilfe des Visual Studio-Debuggers debuggt werden. Weitere Informationen finden Sie unter Debuggen von SharePoint-Workflow-Lösungen (SharePoint 2007).

Dieses Thema enthält folgende Abschnitte.

• Zeicheneinschränkungen in Projekt- und Projektelementnamen
• Fehler beim Erstellen von benutzerdefinierten Feldern
• Neue, nicht englische Websitedefinitionen werden nach dem Bereitstellen nicht auf der Websiteerstellungsseite angezeigt
• Fehler beim Bereitstellen eines Workflowprojekts auf einem unveränderten System
• Der Benutzer muss beim Debuggen die Anwendungsseite im Browser aktualisieren, um ein aktualisiertes Bild anzuzeigen
• Fehler: Der Speicherort der Website ist nicht gültig.
• Das Webereignis für eine Websitelöschung tritt im Ereignisempfängerprojekt nicht ein
• Ein Bereitstellungsfehler tritt auf, nachdem der Name eines Bezeichners in einem Business Data Connectivity-Modell-Projekt geändert wurde
• Fehler beim Versuch, einen visuelles Webpart in SharePoint anzuzeigen
• Fehler beim Ausführen eines importierter wiederverwendbaren Workflows, der ein Aufgabenformularfeld enthält
• Fehler beim Ausführen einer umbenannten importierten Listeninstanz
• SharePoint-Debugsitzung wurde von IIS beendet
• Automatisches Zurückziehen hinterlässt verwaiste Listeninstanz in SharePoint
• Ursprüngliche SharePoint-Lösung wird durch eine exportierte Version ersetzt
• Fehler beim Starten vom Debuggen
• Verwandte Abschnitte

Zeicheneinschränkungen in Projekt- und Projektelementnamen

Projekt- und Projektelementnamen können nur Zeichen enthalten, die in einem Bereitstellungspfad in SharePoint 2010 gültig sind. Andere Zeichen sind nicht zulässig.

Fehlermeldung

Fehlermeldung "Ungültige Zeichen"

Lösung

Verwenden Sie für SharePoint-Projekt- und -Projektelementnamen nur die folgenden Zeichen:

• Alphanumerische ASCII-Zeichen

• Leerzeichen

• Punkt (.)

• Komma (,)

• Unterstrich (_)

• Bindestrich (-)

• Umgekehrter Schrägstrich (\)

Wenn ein Projekt verpackt wird, überprüft eine Gültigkeitsprüfungsregel, ob die Eigenschaft "Bereitstellungspfad" bei jeder Datei, die bereitgestellt wird, nur diese gültigen Zeichen enthält.

Fehler beim Erstellen von benutzerdefinierten Feldern

Benutzerdefinierte Felder in Visual Studio 2010 werden in XML definiert. Wenn ein Feld nicht definiert wird oder mit einem bestimmten Format auf das Feld verwiesen wird, können Fehler auftreten.

Fehlermeldung

Fehlermeldung "Ungültige Zeichen" zur Verpackungszeit.

Lösung

Die ID für eine Felddefinition muss eine von geschweiften Klammern umgebene GUID sein. Beispiel:

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Type="Note" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Group="A Custom Group">
</Field>.

Ein Feldverweis in einen Inhaltstyp muss mit dem leeren Elementformat (<FieldRef />) und nicht mit Start-/Endelemente (<FieldRef></FieldRef>) definiert werden. Beispiel:

<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Required="TRUE"/>

Wenn es ein Problem mit dem XML-Quellcode für das Feld gibt, z. B. wenn er fehlerhaft oder ungültig ist, tritt der Fehler "Cannot parse file" auf.

Neue, nicht englische Websitedefinitionen werden nach dem Bereitstellen nicht auf der Websiteerstellungsseite angezeigt

Nach dem Erstellen und Bereitstellen einer neuen Websitedefinition mit einer nicht englischen Version von Visual Studio 2010 (also einer Version, deren Gebietsschema-ID nicht "1033" lautet) wird im Feld Vorlagenauswahl die Registerkarte SharePoint-Anpassungen nicht angezeigt, und die neue Websitevorlage wird auf der Seite Neue SharePoint-Website nicht angezeigt.

Fehlermeldung

Keine.

Lösung

Dieses Problem tritt aufgrund eines falschen Werts in der Eigenschaft Pfad für die Konfigurationsdatei der webtemp-Websitedefinition (beispielsweise "webtemp_SiteDefinitionProject1.xml") auf. Ändern Sie in der Eigenschaft Pfad für die webtemp-Datei, die sich am Bereitstellungsort befindet, den Wert "1033" zur entsprechenden Gebietsschema-ID. Soll also beispielsweise das Gebietsschema für Japanisch verwendet werden, ändern Sie den Wert zu "1041". Weitere Informationen finden Sie unter Von Microsoft zugewiesene Gebietsschema-IDs.

Fehler beim Bereitstellen eines Workflowprojekts auf einem unveränderten System

Dieses Problem tritt auf, wenn ein Workflowprojekt in Visual Studio 2010 auf einem unveränderten System bereitgestellt wird. Ein unverändertes System ist ein Computer mit einer neuen Installation von Visual Studio 2010 und SharePoint, aber ohne bereitgestellte Workflowprojekte.

Fehlermeldung

Die SharePoint-Liste kann nicht gefunden werden: Workflowverlauf.

Lösung

Dieser Fehler tritt aufgrund einer fehlenden Workflowverlaufsliste auf. Da es sich bei der Entwicklungsumgebung um ein unverändertes System handelt, sind keine Workflows bereitgestellt, und die Workflowverlaufsliste ist noch nicht vorhanden. Öffnen Sie den Workflow-Assistenten, um dieses Problem zu beheben. Dadurch wird die Workflowverlaufsliste erstellt.

So starten Sie den Workflow-Assistenten erneut

1. Wählen Sie im Projektmappen-Explorer den Workflowknoten aus.

2. Klicken Sie im Eigenschaftenfenster bei einer beliebigen Eigenschaft, die eine Schaltfläche mit Auslassungspunkten (…) besitzt, auf die Schaltfläche mit den Auslassungspunkten.

Der Benutzer muss beim Debuggen die Anwendungsseite im Browser aktualisieren, um ein aktualisiertes Bild anzuzeigen

Wenn Sie eine SharePoint-Lösung mit einer Anwendungsseite debuggen, die ein Steuerelement mit einem Bild (beispielsweise ein HTML-Bild-Steuerelement) enthält, muss die Seite im Browser aktualisiert werden, damit am Bild vorgenommene Änderungen angezeigt werden.

Fehler: Der Speicherort der Website ist nicht gültig.

Dieses Problem kann auftreten, wenn SharePoint Server 2010 nicht installiert ist. Es kann auch auftreten, wenn Sie für die SharePoint-Website, die im Assistent zum Anpassen von SharePoint angegeben ist, nicht über Administratorzugriff verfügen.

Fehlermeldung

• Der Speicherort der SharePoint-Site ist nicht gültig.

Lösung

• Installieren Sie SharePoint Server 2010.

• Stellen Sie sicher, dass Sie über Administratorzugriff auf die SharePoint-Website verfügen. Weitere Informationen finden Sie im Office-Onlineartikel Grant access to the portal site.

Das Webereignis für eine Websitelöschung tritt im Ereignisempfängerprojekt nicht ein

Wenn Sie ein Ereignisempfängerprojekt erstellen und Sie bestimmte Webereignisse auswählen, z. B. "eine Website wird gelöscht", tritt das Ereignis nie ein.

Fehlermeldung

Keine.

Lösung

Dieses Problem tritt auf, da der Funktionsbereich "Site" sein muss, um Ereignisse auf Websiteebene zu behandeln, der Standardfunktionsbereich für Ereignisempfängerprojekte ist jedoch "Internet". Die betroffenen Webereignisse sind:

• Eine Website wird gelöscht (WebDeleting)

• Eine Website wurde gelöscht (WebDeleted)

• Eine Website wird verschoben (WebMoving)

• Eine Website wurde verschoben (WebMoved)

Zum Beheben des Problems ändern Sie den Funktionsbereich des Ereignisempfängers wie folgt:

So ändern Sie den Funktionsbereich des Ereignisempfängers

1. Öffnen Sie die Funktion des Ereignisempfängers im Funktions-Designer. Doppelklicken Sie hierzu im Projektmappen-Explorer auf die entsprechende FEATURE-Datei.

2. Klicken Sie auf den Dropdownpfeil neben Bereich.

3. Wählen Sie in der Dropdownliste Site aus.

Ein Bereitstellungsfehler tritt auf, nachdem der Name eines Bezeichners in einem Business Data Connectivity-Modell-Projekt geändert wurde

Dieses Problem tritt auf, wenn Sie den Bezeichnernamen einer Entität in einem Business Data Connectivity-Modell (BDC-Modell) ändern, und dann versuchen, die Projektmappe bereitzustellen.

Fehlermeldungen

• <Modellname> weist die folgenden Aktivierungsfehler für externe Inhaltstypen auf …

• Das IMetadataObject mit dem Namen '<Modellname>' enthält im Feld 'name' einen duplizierten Wert ...

Lösung

Um dieses Problem zu beheben, löschen Sie das Modell manuell, und stellen Sie anschließend die Projektmappe erneut bereit. Sie können das Modell mit einem der folgenden Tools löschen:

• SharePoint 2010-Zentraladministration. Weitere Informationen finden Sie unter Verwalten von BDC-Modellen (SharePoint Server 2010) auf der Microsoft TechNet-Website.

• Windows PowerShell. Durch Eingabe des Befehls Remove-SPBusinessDataCatalogModel an der Eingabeaufforderung können Sie das Modell löschen. Weitere Informationen finden Sie unter Allgemeine Cmdlets (SharePoint Server 2010) auf der Microsoft TechNet-Website.

Fehler beim Versuch, einen visuelles Webpart in SharePoint anzuzeigen

Dieses Problem tritt auf, wenn die Path-Eigenschaft des Benutzersteuerelements nicht mit der Zeichenfolge "CONTROLTEMPLATES\" beginnt.

Fehlermeldungen

• Die Datei "/_CONTROLTEMPLATES/<Projektname >/<Webpartname>/<Benutzersteuerelementname>.ascx" ist nicht vorhanden.

• Serverfehler in "/" Anwendung.

Lösung

So beheben Sie dieses Problem

1. Wählen Sie im Projektmappen-Explorer die Benutzersteuerelementdatei aus. Der Dateiname hat die Erweiterung ".ascx".

2. Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

3. Erweitern Sie im Fenster Eigenschaften den Knoten Bereitstellungsort.

4. Stellen Sie sicher, dass der Wert der Path-Eigenschaft mit der Zeichenfolge "CONTROLTEMPLATES\" beginnt.

Fehler beim Ausführen eines importierter wiederverwendbaren Workflows, der ein Aufgabenformularfeld enthält

Dieses Problem tritt auf, wenn Sie einen Workflow importieren, der ein Aufgabenformular enthält, das über ein Feld verfügt, und dann den neuen Workflow auf dem gleichen System ausführen, aus dem Sie ihn importiert haben.

Fehlermeldung

Fehler in Bereitstellungsschritt "Funktionen aktivieren": Das in der Funktion [Guid] definierte Feld mit ID [Guid] wurde in der aktuellen Websitesammlung oder einer Unterwebsite gefunden.

Lösung

Dieser Fehler ist das Ergebnis von Feld-ID-Konflikten, die auftreten, weil das Projekt "Wiederverwendbaren Workflow importieren" in Visual Studio keine Aufgabenformularfeld-IDs ändert. Wenn Sie einen importierten Workflow auf dem gleichen Server bereitstellen, der den ursprünglichen Workflow enthält, treten Feld-ID-Konflikte auf.

Um dieses Problem zu beheben, verwenden Sie die Funktion "Suchen und Ersetzen", um den Wert des Feld-ID-Attributs in allen importierten Workflowdateien zu ändern.

Fehler beim Ausführen einer umbenannten importierten Listeninstanz

Dieses Problem tritt auf, wenn Sie eine importierte Listeninstanz umbenennen und diese dann in Visual Studio ausführen.

Fehlermeldung

Buildfehler: Fehler Bereitstellungsschritt "Funktionen aktivieren": Die Datei "Template\Features\[import project feature name]\Files\Lists\[old list name]\Schema.xml" ist nicht vorhanden.

Lösung

Wenn Sie eine Listeninstanz importieren, wird der Datei "Elements.xml" der Listeninstanz ein Attribut namens "CustomSchema" hinzugefügt. Die Datei "Elements.xml" schließt den Pfad einer benutzerdefinierten Datei "schema.xml" für die Listeninstanz ein. Wenn Sie die Listeninstanz in Visual Studio umbenennen, ändert sich der Bereitstellungspfad für die benutzerdefinierte Datei "schema.xml", der Pfadwert des CustomSchema-Attributs wird jedoch nicht aktualisiert. Als Ergebnis kann die Listeninstanz die Datei "schema.xml" im alten Pfad, der vom CustomSchema-Attribut angegeben wird, nicht finden, wenn die Funktion aktiviert wird.

Um dieses Problem zu beheben, aktualisieren Sie den Pfad des Bereitstellungsspeicherorts der Datei "schema.xml" im CustomSchema-Attribut.

SharePoint-Debugsitzung wurde von IIS beendet

Dieses Problem tritt auf, wenn Sie einen Haltepunkt in einer Visual Studio-SharePoint-Lösung festlegen, F5 drücken, um ihn auszuführen, und länger als 90 Sekunden bei einem Haltepunkt verweilen.

Fehlermeldung

Der Webserverprozess, der debuggt wurde, wurde von Internetinformationsdienste (Internet Information Services, IIS) beendet. Dies kann vermieden werden, indem die Ping-Einstellungen des Anwendungspools in IIS konfiguriert werden. Weitere Informationen finden Sie in der Hilfe.

Lösung

Standardmäßig wartet der IIS-Anwendungspool 90 Sekunden auf die Antwort einer Anwendung, bevor diese geschlossen wird. Dieser Prozess wird als "Pingen" der Anwendung bezeichnet. Um dieses Problem zu beheben, können Sie entweder die Wartezeit verlängern oder das Pingen der Anwendung komplett deaktivieren.

So greifen Sie auf die IIS-Einstellungen für den Anwendungspool zu

1. Öffnen Sie IIS-Manager.

2. Erweitern Sie im Bereich Verbindungen den SharePoint-Serverknoten, und klicken Sie auf Anwendungspools.

3. Wählen Sie auf der Seite Anwendungspools den SharePoint-Anwendungspool (in der Regel "SharePoint - 80") aus, und klicken Sie im Bereich Aktionen auf Erweiterte Einstellungen.

4. Um die Wartezeit bis zu einem IIS-Timeout zu verlängern, ändern Sie den Wert von Maximale Ping-Antwortzeit (Sekunden) auf einen Wert, der größer als 90 Sekunden ist.

5. Legen Sie Ping aktiviert auf False fest, um das Pingen von IIS zu deaktivieren.

Automatisches Zurückziehen hinterlässt verwaiste Listeninstanz in SharePoint

Dieses Problem tritt auf, wenn Sie die folgenden Schritte ausführen:

1. Erstellen einer Listendefinition, die in Visual Studio 2010 eine Listeninstanz hat.

2. Drücken Sie F5, um die Projektmappe auszuführen.

3. Beenden des Debugvorgangs oder Schließen der SharePoint-Website.

4. Erneutes Öffnen der SharePoint-Website und Öffnen der Listeninstanz.

Fehlermeldung

Serverfehler in "/" Anwendung.

Lösung

Dies geschieht, weil die Funktion zum automatischen Zurückziehen die Lösung zurückzieht, nachdem Sie eine Debugsitzung einer SharePoint-Lösung geschlossen haben. Die Zurückziehen löscht die Listendefinition aus SharePoint, jedoch nicht die Instanz der Liste. Die zugrunde liegende Listendefinition ist für die Listeninstanz erforderlich.

Zum Beheben dieses Problems klicken Sie im Menü Erstellen auf Bereitstellen, um die Projektmappe bereitzustellen. (Verwenden Sie nicht F5 zum Debuggen.) Löschen Sie dann die Listeninstanz in SharePoint.

Ursprüngliche SharePoint-Lösung wird durch eine exportierte Version ersetzt

Wenn Sie eine SharePoint-Lösung exportieren, die Projektmappe in Visual Studio importieren und dann wieder auf der gleichen Website bereitstellen, von der sie exportiert wurde, wird die ursprüngliche SharePoint-Lösung ersetzt. Dieses Problem tritt nicht auf, wenn Sie die Projektmappe auf einem Server bereitstellen, auf dem die ursprüngliche Projektmappe nicht aktiviert ist.

Fehlermeldung

Keine.

Lösung

Um zu verhindern, dass eine Projektmappe auf der Website überschreiben wird, von der sie exportiert wurde, ändern Sie die GUIDS der SolutionID und der Funktions-IDs aller importierten Funktionen im Visual Studio-Projekt.

Fehler beim Starten vom Debuggen

Wenn Sie mit dem Debuggen einer SharePoint-Lösung in Visual Studio beginnen, erhalten Sie eine Fehlermeldung, dass Visual Studio die Konfigurationsdatei "Web.config" nicht laden konnte, da der angegebene Schlüssel im Wörterbuch nicht vorhanden war.

Fehlermeldung

Die Konfigurationsdatei "Web.config" konnte nicht geladen werden. Überprüfen Sie die Datei auf falsch formatierte XML-Elemente, und versuchen Sie es erneut. Fehler: Der angegebene Schlüssel war im Wörterbuch nicht vorhanden.

Lösung

Um dieses Problem zu beheben, stellen Sie sicher, dass der Website-URL-Eigenschaftswert des SharePoint-Projekts in Visual Studio eine Entsprechung für die URL findet, die der Standardzone für die alternativen Zugriffszuordnungen der Webanwendung zugewiesen wurde. Das Verwenden einer anderen Zone, z. B. Intranet, für die URL behebt den Fehler nicht. Die Website-URL des Projekts und die URL in der Standardzone müssen gleich sein. Um auf alternative Zugriffszuordnungen zuzugreifen, klicken Sie im Hilfsprogramm "SharePoint 2010-Zentraladministration" auf Anwendungsverwaltung, und klicken Sie dann unter Webanwendungen auf den Link Alternative Zugriffszuordnungen konfigurieren. Weitere Informationen finden Sie unter Erstellen von Zonen für Webanwendungen.

Siehe auch

Weitere Ressourcen

Problembehandlung beim SharePoint-Packen und -Bereitstellen

Erstellen und Debuggen von SharePoint-Lösungen

Debuggen in Visual Studio