Freigeben über


Erstellen von Anwendungsseiten für SharePoint

Eine Anwendungsseite ist eine ASP.NET-Webseite, die für die Verwendung in einer SharePoint-Website ausgelegt ist. Anwendungsseiten sind ein spezialisierter Typ einer ASP.NET-Seite. Der primäre Unterschied zwischen einer Anwendungsseite und einer ASP.NET-Standardseite besteht darin, dass eine Anwendungsseite Inhalt enthält, der mit einer SharePoint-Masterseite zusammengeführt wird. Eine Masterseite aktiviert Anwendungsseiten, die dieselbe Darstellung und dasselbe Verhalten wie andere Seiten auf einer Site aufweisen.

Visual Studio ermöglicht es Ihnen, Anwendungsseiten mit einem Designer zu entwerfen. Der Designer zeigt einen Inhaltsbereich für jeden Inhaltsplatzhalter an, der in einer Masterseite definiert wird. Sie können die Anwendungsseite entwerfen, indem Sie Steuerelemente in diese Inhaltsbereiche ziehen.

Anwendungsseiten

Anwendungsseiten werden von allen Websites auf dem Server gemeinsam genutzt, wohingegen eine Websiteseite spezifisch für eine Website ist. Weitere Informationen finden Sie unter SharePoint-Seitentypen.

Standardmäßig sind die meisten der Seiten, die angezeigt werden, wenn Sie eine SharePoint-Website erstellen, Websiteseiten. Eine Websiteseite kann einer SharePoint-Seitenbibliothek hinzugefügt werden. Benutzer können eine Websiteseite mit Tools wie dem SharePoint Designer anpassen. Eine Websiteseite kann auch Funktionen hosten, z. B. dynamische Webparts und Webpartzonen.

Bei Anwendungsseiten ist dies nicht möglich. Es ist jedoch empfehlenswert, eine Anwendungsseite zu erstellen, wenn die Seite benutzerdefinierten Code enthalten soll. Obwohl Sie einer Websiteseite benutzerdefinierten Code hinzufügen können, wird die Ausführung des Codes beendet, wenn der Benutzer die Seite mit Tools wie dem SharePoint Designer anpasst.

Tipp

Visual Studio stellt keine Vorlagen bereit, die Sie beim Erstellen von Websiteseiten für eine SharePoint-Website unterstützen. Weitere Informationen finden Sie unter SharePoint-Seitentypen.

Erstellen einer Anwendungsseite

Um eine Anwendungsseite zu erstellen, fügen Sie einem SharePoint-Projekt ein Element Anwendungsseite hinzu. Wenn Sie eine Anwendungsseite erstellen, fügt Visual Studio dem Projekt die folgenden Ordner hinzu:

Ordner

Beschreibung

Layouts

Entspricht dem virtuellen Verzeichnis _layouts des SharePoint-Dateisystems.

Unterordner Layouts

Enthält die Dateien, aus denen die Anwendungsseite besteht. Standardmäßig weist dieser Ordner denselben Namen auf wie das Projekt. Sie können diesen Ordner jedoch jederzeit umbenennen. Wenn Sie das Projekt ausführen, stellt Visual Studio diesen Ordner im virtuellen Verzeichnis _layouts des SharePoint-Dateisystems bereit.

Visual Studio fügt dem Projekt die folgenden Dateien hinzu:

Datei

Beschreibung

ASP.NET-Seitendatei (*.aspx)

Enthält XML-Markup, das die Seite definiert.

Codedatei für die Anwendungsseite

Enthält Code hinter der Anwendungsseite. Fügen Sie dieser Datei Code hinzu, der Ereignisse behandelt.

Codedatei des Anwendungsseiten-Designers

Enthält Code, der vom Designer generiert wird. Bearbeiten Sie diese Datei nicht direkt.

Entwerfen und Debuggen einer Anwendungsseite

Entwerfen Sie den Inhalt einer Anwendungsseite mit dem Visual Web Developer-Designer in Visual Studio. Dieser Designer wird angezeigt, wenn Sie im Projekt auf die Anwendungsseite doppelklicken. Weitere Informationen zur Verwendung dieses Designers finden Sie unter Einstieg in Visual Web Developer.

Tipp

Sie können die Seite nur in der Quellansicht des Designers entwerfen. Die Entwurfsansicht des Designers ist für Anwendungsseiten deaktiviert.

Sie können eine Anwendungsseite auf dieselbe Weise debuggen wie Sie andere SharePoint-Projektelemente in Visual Studio debuggen. Wenn Sie den Visual Studio-Debugger starten, wird von Visual Studio die SharePoint-Website geöffnet.

Um die Anwendungsseite anzuzeigen, müssen Sie manuell zur Position der Anwendungsseite navigieren (z. B.: https://Server_Name/_layouts/Project_Name/ApplicationPage1.aspx).

Weitere Informationen zum Debuggen von SharePoint-Projekten finden Sie unter Problembehandlung bei SharePoint-Lösungen.

Auswählen einer Masterseite

Standardmäßig verweist ein Element Anwendungsseite auf die Masterseite der Site, mit der Sie das Projekt debuggen. Diese Seite hat den Namen v4.master und ist auf der SharePoint-Website im Gestaltungsvorlagenseite verfügbar.

Sie können explizit ändern, welche Gestaltungsvorlage von der Anwendungsseite verwendet wird, indem Sie das MasterPageFile-Attribut des Page-Elements der Anwendung festlegen. (Beispiel: MasterPageFile="~/_layouts/applicationv4.master"). Sie müssen dieses Attribut sogar festlegen, wenn dynamische Masterseiten nicht auf dem SharePoint-Server aktiviert sind. Weitere Informationen zu Gestaltungsvorlagen in SharePoint finden Sie im Thema zu Gestaltungsvorlagen (möglicherweise in englischer Sprache).

Siehe auch

Konzepte

Übersicht über ASP.NET-Webseiten

Übersicht über die Syntax von ASP.NET-Webseiten

Weitere Ressourcen

SharePoint Foundation-Entwicklung im Detail

Programmieren von ASP.NET-Webseiten