Freigeben über


Erstellen von Anwendungsseiten für SharePoint

Eine Anwendungsseite ist eine ASP.NET Webseite, die für die Verwendung in einer SharePoint-Website entwickelt wurde. Anwendungsseiten sind ein spezieller Typ von ASP.NET Seite. Der Hauptunterschied zwischen einer Anwendungsseite und einer Standard-ASP.NET Seite besteht darin, dass eine Anwendungsseite Inhalte enthält, die mit einer SharePoint-Gestaltungsvorlage zusammengeführt werden. Mithilfe einer Masterseite können Anwendungsseiten das gleiche Erscheinungsbild und Verhalten wie andere Seiten auf einer Website teilen.

Mit Visual Studio können Sie Anwendungsseiten mithilfe eines Designers entwerfen. Der Designer zeigt einen Inhaltsbereich für jeden Inhaltsplatzhalter an, der in einer Masterseite definiert ist. Sie können die Anwendungsseite entwerfen, indem Sie Steuerelemente in diese Inhaltsbereiche ziehen.

Anwendungsseiten

Anwendungsseiten werden auf allen Websites auf dem Server freigegeben, während eine Websiteseite spezifisch für eine Website ist. Weitere Informationen: SharePoint-Seitentypen.

Standardmäßig sind die meisten Seiten, die beim Erstellen einer SharePoint-Website angezeigt werden, Websiteseiten. Eine Websiteseite kann einer SharePoint-Seitenbibliothek hinzugefügt werden. Benutzer können eine Websiteseite mithilfe von Tools wie SharePoint Designer anpassen. Eine Seite kann auch Features wie dynamische Webparts und Webpartzonen hosten.

Anwendungsseiten können diese Aktionen nicht ausführen. Eine Anwendungsseite ist jedoch der beste Typ der zu erstellenden Seite, wenn die Seite benutzerdefinierten Code enthalten soll. Obwohl Sie einer Websiteseite benutzerdefinierten Code hinzufügen können, wird der Code beendet, wenn der Benutzer die Seite mithilfe von Tools wie SharePoint Designer angepasst.

Hinweis

Visual Studio stellt keine Vorlagen bereit, mit denen Sie Websiteseiten für eine SharePoint-Website erstellen können. Weitere Informationen finden Sie unter SharePoint-Seitentypen.

Erstellen einer Anwendungsseite

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

Ordner Description
Layouts Ordnet das virtuelle Verzeichnis _layouts im SharePoint-Dateisystem zu.
Layouts-Unterordner Enthält die Dateien, aus denen die Anwendungsseite besteht. Standardmäßig hat dieser Ordner denselben Namen wie Ihr Projekt. Sie können diesen Ordner jederzeit umbenennen. Wenn Sie das Projekt ausführen, stellt Visual Studio diesen Ordner im _layouts virtuellen Verzeichnis des SharePoint-Dateisystems bereit.

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

Datei Description
ASP.NET Seitendatei (.aspx) Enthält XML-Markup, das die Seite definiert.
Codedatei der Anwendungsseite Enthält Code hinter der Anwendungsseite. Fügen Sie Code hinzu, der Ereignisse in dieser Datei behandelt.
Codedatei für Anwendungsseiten-Designer 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 mithilfe der Designeransicht in Visual Studio. Dieser Designer wird angezeigt, wenn Sie die Anwendungsseite in Ihrem Projekt öffnen (indem Sie darauf doppelklicken oder das Kontextmenü öffnen und dann " Öffnen" auswählen) und dann unten im Editor die Schaltfläche " Entwurf " auswählen.

Hinweis

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 genauso debuggen wie andere SharePoint-Projektelemente in Visual Studio. Wenn Sie den Visual Studio-Debugger starten, öffnet Visual Studio die SharePoint-Website.

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

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

Masterseite auswählen

Standardmäßig verweist ein Anwendungsseitenelement auf die Gestaltungsvorlage der Website, die Sie zum Debuggen des Projekts verwenden. Diese Seite heißt "v4.master", und Sie finden sie im Gestaltungsvorlagenkatalog der SharePoint-Website.

Sie können explizit ändern, welche Masterseite von der Anwendungsseite verwendet wird, indem Sie das MasterPageFile-Attribut des Anwendungselements Page festlegen. (Beispiel: MasterPageFile="~/_layouts/applicationv4.master"). In der Tat, müssen Sie dieses Attribut festlegen, wenn dynamische Masterseiten auf dem SharePoint-Server nicht aktiviert sind. Weitere Informationen zu Masterseiten in SharePoint finden Sie unter Masterseiten.