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 Debugging SharePoint Workflow Solutions.

Dieses Thema enthält folgende Abschnitte.

• Scheineinschränkungen in Sandkasten-Visual-Webparten
• Zeicheneinschränkungen in Projekt- Namen von Projekten und Projektelementen
• 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 angezeigt wird, wenn er beginnt Debuggen
• Verwandte Themen

Scheineinschränkungen in Sandkasten-Visual-Webparten

Visuelle Webparts in Sandkastenlösungen können Standardtoken, wie $SPUrl nicht verarbeiten, dies die SharePoint-Laufzeitunterstützung.Daher wird die URL nicht aufgelöst, und Sie können den Inhalt in der Entwurfsansicht im visuellen Webpartdesigner, wenn Sie es direkt in einem Skriptelement verweisen, wie im folgenden Beispiel nicht in der Vorschau anzeigen:

<script src=”<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>

Um diese Einschränkung zu umgehen und Token zu beheben, können Sie sie mithilfe von Literalen verwenden:

<asp:literal ID="Literal1" runat="server" Text="&lt;script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' &gt;&lt;/script&gt;" />

Zeicheneinschränkungen in Projekt- Namen von Projekten und Projektelementen

Namen von Projekten und Projektelementen 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

Für Namen von SharePoint-Projekten und -Projektelementen, wird nur die folgenden Zeichen:

• Alphanumerische ASCII-Zeichen

• Leerzeichen

• Punkt (.)

• Komma (,)

• Unterstrich (_)

• Bindestrich (-)

• Umgekehrter Schrägstrich (\)

Wenn ein Projekt verpackt wird, überprüft eine Validierungsregel, dass die BereitstellungPfadeigenschaft für jede Datei, die Sie bereitstellen, nur diese gültigen Zeichen enthält.

Fehler beim Erstellen von benutzerdefinierten Feldern

In Visual Studio werden benutzerdefinierte Felder in XML definiert.Fehler können auftreten, wenn ein Feld nicht definiert oder verwiesen wird, indem ein bestimmtes Format verwendet.

Fehlermeldung

Fehlermeldung "Ungültige Zeichen" zur Verpackungszeit.

Lösung

Die ID für eine Felddefinition muss ein GUID sein, das von geschweiften Klammern umgeben ist, wie im folgenden Beispiel dargestellt:

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

Wie im folgenden Beispiel gezeigt, ein Feldverweis in einem Inhaltstyp definiert werden müssen, indem das leeren Elementformat (<FieldRef />) verwendet, nicht mithilfe von Start/Endenelementen (<FieldRef></FieldRef>):

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

Wenn die XML-Quellcode für das Feld fehlerhaft ist, keine gültige XML-Datei ist oder ein anderes Problem aufweist, kann der Fehler "Cannot parse" auf.

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

Nachdem Sie eine Websitedefinition erstellen und bereitstellen, indem Sie eine nicht englischen Version von Visual Studio (das heißt, eine Version mit einem Gebietsschema ID auf 1033) verwenden, wird die Registerkarte SharePoint-Anpassungen nicht im Feld Vorlagenauswahl und die neue Websitevorlage wird nicht auf der Seite Neue SharePoint-Website.

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 auf einem unveränderten System bereitgestellt.Ein unverändertes System ist ein Computer, der eine neue Installation von Visual Studio und SharePoint jedoch keine bereitgestellte Workflowprojekte verfügt.

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. In Projektmappen-Explorer wählen Sie den Workflowknoten aus.

2. Im Eigenschaften Sie im auf die Auslassungszeichen (...) Schaltfläche Sie auf jeder Eigenschaft, die eine 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. In Projektmappen-Explorer öffnen Sie die FEATURE-Datei des Ereignisempfängers im Funktions-Designer, indem Sie entweder auf die Datei doppelklicken oder dessen Kontextmenü öffnen und dann Öffnen auswählen.

2. Wählen Sie den Pfeil neben Bereich aus, und wählen Sie dann Site in der Liste aus, die angezeigt wird.

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. In Projektmappen-Explorer wählen Sie die Benutzersteuerelementdatei aus, deren Dateinamenerweiterung .ascx ist.

2. Wählen Sie auf der Menüleiste die Optionen Ansicht und Eigenschaftenfenster aus.

3. Erweitern Sie im Fenster Eigenschaften den Knoten Bereitstellungsort.

4. Stellen Sie dass der Wert der Pfad-Eigenschaftanfänge mit der Zeichenfolge "CONTROLTEMPLATES \".

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 projectfeaturename]\Files\Lists\[oldlist 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, die F5-TASTE auswählen, um sie auszuführen, und bleibt dann an einem Haltepunkt länger als 90 Sekunden.

Fehlermeldung

Der Webserverprozess, der debuggt wurde, wurde von Internetinformationsdienste (Internet Information Services, IIS) beendet.Sie können dieses Problem vermeiden, indem Sie Ping-Einstellungen des Anwendungspools in IIS konfigurieren.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. Im Bereich Verbindungen erweitern Sie den SharePoint-Server-Knoten, und wählen Sie dann den Knoten Anwendungspools aus.

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

4. Um die Wartezeit vor IIS-Timeout zu erhöhen, ä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 eine Listeninstanz hat.

2. Wählen Sie die F5-TASTE, 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.

Um dieses Problem zu beheben, stellen Sie die Projektmappe von, auf der Menüleiste bereit und Erstellen auswählen, Bereitstellen.(Debuggen Sie die Projektmappe nicht, indem Sie die F5-TASTE auswählen). 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 angezeigt wird, wenn er beginnt Debuggen

Wenn Sie starten, um eine SharePoint-Lösung in Visual Studio zu debuggen, gibt ein Fehler an, dass Visual Studio die Web.config-Datei nicht laden konnte, da der angegebene Schlüssel im Wörterbuch nicht 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 der Website-URL-Eigenschaftswert des SharePoint-Projekts in Visual Studio URL entspricht die der Standardzone für die alternativen Zugriffszuordnungen der Webanwendung zugewiesen wird.Sie können den Fehler nicht beheben, indem Sie eine andere Zone, wie Intranet, für die URL verwenden.Die Website-URL für das Projekt und die URL in der Standardzone müssen übereinstimmen.Um auf alternative Zugriffszuordnungen zuzugreifen, öffnen Sie das Hilfsprogramm "SharePoint 2010-Zentraladministration", wählen Sie den Anwendungsverwaltung Link und dann, unter Webanwendungen auswählen, den Alternative Zugriffszuordnungen konfigurieren Link aus.Weitere Informationen finden Sie unter Erstellen von Zonen für Webanwendungen.

Siehe auch

Konzepte

Problembehandlung beim SharePoint-Packen und -Bereitstellen

Weitere Ressourcen

Erstellen und Debuggen von SharePoint-Lösungen

Debuggen in Visual Studio