Creare pagine dell'applicazione per SharePoint

  • Articolo

Una pagina dell'applicazione è una pagina Web ASP.NET progettata per l'uso in un sito Web di SharePoint. Le pagine dell'applicazione sono un tipo specializzato di ASP.NET pagina. La differenza principale tra una pagina dell'applicazione e una pagina ASP.NET standard consiste nel fatto che una pagina dell'applicazione contiene contenuto unito a una pagina master di SharePoint. Una pagina master consente alle pagine dell'applicazione di condividere lo stesso aspetto e comportamento delle altre pagine di un sito.

Visual Studio consente di progettare le pagine dell'applicazione usando una finestra di progettazione. La finestra di progettazione visualizza un'area di contenuto per ogni segnaposto contenuto definito in una pagina master. È possibile progettare la pagina dell'applicazione trascinando i controlli in queste aree di contenuto.

Pagine dell'applicazione

Le pagine dell'applicazione vengono condivise in tutti i siti nel server, mentre una pagina del sito è specifica di un sito. Per altre informazioni, tipi di pagina di SharePoint.

Per impostazione predefinita, la maggior parte delle pagine visualizzate quando si crea un sito di SharePoint sono pagine del sito. È possibile aggiungere una pagina del sito a una raccolta pagine di SharePoint. Gli utenti possono personalizzare una pagina del sito usando strumenti come SharePoint Designer. Una pagina del sito può anche ospitare funzionalità quali Web part dinamiche e zone web part.

Le pagine dell'applicazione non possono eseguire queste operazioni. Tuttavia, una pagina dell'applicazione è il tipo migliore di pagina da creare se si vuole che la pagina contenga codice personalizzato. Sebbene sia possibile aggiungere codice personalizzato a una pagina del sito, il codice si interrompe quando l'utente personalizza la pagina usando strumenti come SharePoint Designer.

Nota

Visual Studio non fornisce modelli che consentono di creare pagine del sito per un sito di SharePoint. Per altre informazioni, vedere Tipi di pagina di SharePoint.

Creare una pagina dell'applicazione

Per creare una pagina dell'applicazione, aggiungere un elemento pagina applicazione a un progetto SharePoint. Quando si crea una pagina dell'applicazione, Visual Studio aggiunge le cartelle seguenti al progetto:

Cartella Descrizione
Layout Mappe alla directory virtuale _layouts del file system di SharePoint.
Sottocartella Layout Contiene i file che costituiscono la pagina dell'applicazione. Per impostazione predefinita, questa cartella ha lo stesso nome del progetto. È possibile rinominare questa cartella in qualsiasi momento. Quando si esegue il progetto, Visual Studio distribuisce questa cartella nella directory virtuale _layouts del file system di SharePoint.

Visual Studio aggiunge i file seguenti al progetto:

File Descrizione
ASP.NET file di pagina (con estensione aspx) Contiene markup XML che definisce la pagina.
File di codice della pagina dell'applicazione Contiene il codice della pagina dell'applicazione. Aggiungere codice che gestisce gli eventi a questo file.
File di codice della finestra di progettazione delle pagine dell'applicazione Contiene il codice generato dalla finestra di progettazione. Non modificare direttamente il file.

Progettare ed eseguire il debug di una pagina dell'applicazione

Progettare il contenuto di una pagina di un'applicazione usando la visualizzazione della finestra di progettazione in Visual Studio. Questa finestra di progettazione viene visualizzata quando si apre la pagina dell'applicazione nel progetto (facendo doppio clic su di esso o aprendo il relativo menu di scelta rapida e quindi scegliendo Apri) e quindi scegliere il pulsante Progettazione nella parte inferiore dell'editor.

Nota

È possibile progettare la pagina solo nella visualizzazione Origine della finestra di progettazione. La visualizzazione Progettazione della finestra di progettazione è disabilitata per le pagine dell'applicazione.

È possibile eseguire il debug di una pagina dell'applicazione esattamente come si eseguirà il debug di altri elementi del progetto SharePoint in Visual Studio. Quando si avvia il debugger di Visual Studio, Visual Studio apre il sito di SharePoint.

Per visualizzare la pagina dell'applicazione, è necessario passare manualmente alla posizione della pagina dell'applicazione, ad esempio http:// Server_Name/_layouts/Project_Name/ApplicationPage1.aspx.

Per altre informazioni su come eseguire il debug di progetti SharePoint, vedere Risolvere i problemi relativi alle soluzioni SharePoint.

Scegliere una pagina master

Per impostazione predefinita, un elemento pagina applicazione fa riferimento alla pagina master del sito in uso per eseguire il debug del progetto. Tale pagina è denominata v4.master ed è possibile trovarla elencata nella Raccolta pagine master del sito di SharePoint.

È possibile modificare in modo esplicito la pagina master usata dalla pagina dell'applicazione impostando l'attributo MasterPageFile dell'elemento dell'applicazione Page . (ad esempio: MasterPageFile="~/_layouts/applicationv4.master"). In effetti, è necessario impostare questo attributo se le pagine master dinamiche non sono abilitate nel server SharePoint. Per altre informazioni sulle pagine master in SharePoint, vedere Pagine master.

Contenuto correlato