Partager via


Créer des pages d’application pour SharePoint

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 ASP.NET page. La principale différence entre une page d’application et une page de ASP.NET standard est qu’une page d’application contient du contenu 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 d’autres pages sur 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 de l’application en faisant glisser des contrôles vers ces zones de contenu.

Pages d’application

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

Par défaut, la plupart des pages qui apparaissent 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 que la page 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.

Note

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 Descriptif
Dispositions Mappe au répertoire virtuel _layouts du système de fichiers SharePoint.
Sous-dossier Layouts Contient les fichiers qui composent la page de l’application. Par défaut, ce dossier porte le même nom que votre projet. Vous pouvez renommer 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 Descriptif
fichier de page ASP.NET (.aspx) Contient le balisage XML qui définit la page.
Fichier de codes de page d’application Contient le code sous-jacent de la page de l’application. Ajoutez du code qui gère les événements à ce fichier.
Fichier de code du concepteur de pages d’application Contient du 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 de la vue concepteur dans Visual Studio. Ce concepteur s’affiche 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 choisissez le bouton Création en bas de l’éditeur.

Note

Vous ne pouvez concevoir la page que dans l’affichage Source du concepteur. L’affichage Création 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 de l’application, vous devez accéder manuellement à l’emplacement de la page de l’application (par exemple : http:// Server_Name/_layouts/Project_Name/ApplicationPage1.aspx).

Pour plus d’informations sur la façon de déboguer des 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 répertoriée dans la galerie de pages maîtres du site SharePoint.

Vous pouvez modifier explicitement la page maître utilisée par la page d’application en définissant l’attribut MasterPageFile de l’élément d’application Page . (Par exemple : MasterPageFile="~/_layouts/applicationv4.master"). En fait, 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.