Créer des pages d’application pour SharePoint

  • Article

Une page d’application est une page web ASP.NET conçue pour être utilisée dans un site web SharePoint. Les pages d’application sont un type spécialisé de page ASP.NET. La principale différence entre une page d’application et une page ASP.NET standard est qu’une page d’application contient du contenu qui est fusionné avec une page maître SharePoint. Une page maître permet aux pages d’application de partager la même apparence et le même comportement que les autres pages d’un site.

Visual Studio vous permet de concevoir des pages d’application à l’aide d’un concepteur. Le concepteur affiche une zone de contenu pour chaque espace réservé de contenu défini dans une page maître. Vous pouvez concevoir la page d’application en faisant glisser des contrôles vers ces zones de contenu.

Pages d’application

Les pages d’application sont partagées entre tous les sites sur le serveur, tandis qu’une page de site est spécifique à un site. Pour plus d’informations, consultez Types de pages SharePoint.

Par défaut, la plupart des pages qui s’affichent lorsque vous créez un site SharePoint sont des pages de site. Une page de site peut être ajoutée à une bibliothèque de pages SharePoint. Les utilisateurs peuvent personnaliser une page de site à l’aide d’outils, tels que SharePoint Designer. Une page de site peut également héberger des fonctionnalités, telles que des composants WebPart dynamiques et des zones de composants WebPart.

Les pages d’application ne peuvent pas effectuer ces opérations. Toutefois, une page d’application est le meilleur type de page à créer si vous souhaitez qu’elle contienne du code personnalisé. Bien que vous puissiez ajouter du code personnalisé à une page de site, le code cesse de s’exécuter lorsque l’utilisateur personnalise la page à l’aide d’outils, tels que SharePoint Designer.

Notes

Visual Studio ne fournit pas de modèles qui vous aident à créer des pages de site pour un site SharePoint. Pour plus d’informations, consultez Types de pages SharePoint.

Créer une page d’application

Pour créer une page d’application, ajoutez un élément Page d’application à un projet SharePoint. Lorsque vous créez une page d’application, Visual Studio ajoute les dossiers suivants à votre projet :

Dossier Description
Dispositions Mappe vers le répertoire virtuel _layouts du système de fichiers SharePoint.
Sous-dossier Dispositions Contient les fichiers qui composent la page d’application. Par défaut, ce dossier porte le même nom que votre projet. Vous pouvez modifier le nom de ce dossier à tout moment. Lorsque vous exécutez le projet, Visual Studio déploie ce dossier dans le répertoire virtuel _layouts du système de fichiers SharePoint.

Visual Studio ajoute les fichiers suivants à votre projet :

Fichier Description
Fichier de page ASP.NET (.aspx) Contient le balisage XML qui définit la page.
Fichier de code de la page d’application Contient le code derrière la page d’application. Ajoutez du code qui gère les événements de ce fichier.
Fichier de code du concepteur de pages d’application Contient le code généré par le concepteur. Ne modifiez pas directement ce fichier.

Concevoir et déboguer une page d’application

Concevez le contenu d’une page d’application à l’aide du mode Concepteur dans Visual Studio. Ce concepteur apparaît lorsque vous ouvrez la page de l’application dans votre projet (en double-cliquant dessus ou en ouvrant son menu contextuel, puis en choisissant Ouvrir), puis cliquez sur le bouton Concevoir en bas de l’éditeur.

Notes

Vous pouvez concevoir la page uniquement dans la vue Source du concepteur. Le mode Concevoir du concepteur est désactivé pour les pages d’application.

Vous pouvez déboguer une page d’application comme vous le feriez pour déboguer d’autres éléments de projet SharePoint dans Visual Studio. Lorsque vous démarrez le débogueur Visual Studio, Visual Studio ouvre le site SharePoint.

Pour afficher la page d’application, vous devez accéder manuellement à l’emplacement de la page d’application (par exemple : http://Server_Name/_layouts/Project_Name/ApplicationPage1.aspx).

Pour plus d’informations sur le débogage de projets SharePoint, consultez Résoudre les problèmes liés aux solutions SharePoint.

Choisir une page maître

Par défaut, un élément Page d’application fait référence à la page maître du site que vous utilisez pour déboguer votre projet. Cette page est nommée v4.master et vous pouvez la trouver dans la Galerie des pages maîtres du site SharePoint.

Vous pouvez explicitement modifier la page maître utilisée par la page d’application en définissant l’attribut MasterPageFile de l’élément Page de l’application. (Par exemple : MasterPageFile="~/_layouts/applicationv4.master"). En effet, vous devez définir cet attribut si les pages maîtres dynamiques ne sont pas activées sur le serveur SharePoint. Pour plus d’informations sur les pages maîtres dans SharePoint, consultez Pages maîtres.

Contenu connexe