Erstellen von Anwendungsseiten für SharePoint

  • Artikel

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

Visual Studio ermöglicht es Ihnen, Anwendungsseiten mithilfe eines Designers zu entwerfen. Der Designer zeigt einen Inhaltsbereich für jeden in einer Gestaltungsvorlage definierten Inhaltsplatzhalter an. Sie können die Anwendungsseite gestalten, indem Sie Steuerelemente in diese Inhaltsbereiche ziehen.

Anwendungsseiten

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

Standardmäßig sind die meisten bei der Erstellung einer SharePoint-Website angezeigten Seiten Websiteseiten. Eine Websiteseite kann einer SharePoint-Seitenbibliothek hinzugefügt werden. Benutzer können eine Websiteseite mithilfe von Tools wie SharePoint Designer anpassen. Eine Websiteseite kann außerdem Features wie dynamische Webparts und Webpartzonen hosten.

Anwendungsseiten können dies nicht leisten. Eine Anwendungsseite ist jedoch der beste Seitentyp, wenn die Seite benutzerdefinierten Code enthalten soll. Sie können zwar auch einer Websiteseite benutzerdefinierten Code hinzufügen, aber der Code wird nicht mehr ausgeführt, wenn der Benutzer die Seite mithilfe von Tools wie z. B. SharePoint Designer anpasst.

Hinweis

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

Erstellen einer Anwendungsseite

Zum Erstellen einer Anwendungsseite fügen Sie einem SharePoint-Projekt ein Element des Typs Anwendungsseite hinzu. Wenn Sie eine Anwendungsseite erstellen, fügt Visual Studio Ihrem Projekt die folgenden Ordner hinzu:

Ordner BESCHREIBUNG
Layouts Ist dem virtuellen Verzeichnis „_layouts“ im SharePoint-Dateisystem zugeordnet.
Unterordner „Layouts“ 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 virtuellen Verzeichnis „_layouts“ des SharePoint-Dateisystems bereit.

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

Datei BESCHREIBUNG
ASP.NET-Seitendatei (ASPX) Enthält XML-Markup, das die Seite definiert.
Codedatei der Anwendungsseite Enthält Code hinter der Anwendungsseite. Fügen Sie dieser Datei Code für die Ereignisbehandlung hinzu.
Codedatei des Anwendungsseiten-Designers Enthält Code, der vom Designer generiert wird. Bearbeiten Sie diese Datei nicht direkt.

Gestalten und Debuggen einer Anwendungsseite

Gestalten Sie den Inhalt einer Anwendungsseite mithilfe der Designer-Ansicht in Visual Studio. Dieser Designer wird angezeigt, wenn Sie die Anwendungsseite in Ihrem Projekt öffnen (indem Sie darauf doppelklicken oder das zugehörige Kontextmenü öffnen und dann Öffnen auswählen) und anschließend unten im Editor auf die Schaltfläche Entwurf klicken.

Hinweis

Sie können die Seite nur in der Ansicht Quelle des Designers gestalten. Die Ansicht Entwurf des Designers ist für Anwendungsseiten deaktiviert.

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

Zur Anzeige der Anwendungsseite müssen Sie manuell zum Speicherort der Anwendungsseite navigieren (zum Beispiel: http://Servername/_layouts/Projektname/ApplicationPage1.aspx).

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

Auswählen einer Gestaltungsvorlage

Standardmäßig verweist ein Element des Typs Anwendungsseite auf die Gestaltungsvorlage der Website, die Sie zum Debuggen Ihres Projekts verwenden. Diese Seite trägt den Namen „v4.master“ und befindet sich im Gestaltungsvorlagenkatalog der SharePoint-Website.

Sie können die von der Anwendungsseite verwendete Gestaltungsvorlage explizit ändern, indem Sie das MasterPageFile-Attribut des Page-Elements der Anwendung festlegen. (Beispiel: MasterPageFile="~/_layouts/applicationv4.master"). Tatsächlich müssen Sie dieses Attribut festlegen, wenn keine dynamischen Gestaltungsvorlagen für den SharePoint-Server aktiviert sind. Weitere Informationen zu Gestaltungsvorlagen in SharePoint finden Sie unter Gestaltungsvorlagen.

Zugehöriger Inhalt